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머 리 말 


머 리 말 

Windows 2000 은 를퓨터를 최적조건에서 동작시키기 위해 Microsoft 가 21 세기를 
지 향하여 개 발한 조작체 계 이 다. Windows 2000은 최 신의 32bit 를퓨터 기 술의 표준으로서 
자기의 위력을 충분히 발휘하고 있다. Windows 2000 은 프로그람전문가들이 기대하고 
바라오던 대 단히 도전적 인 프로그람개 발환경이 다. 물론 이 도전을 받아 들이면 커 다란 
리익이 있다. 

Windows 2000 은 충분히 조정되 고 엄 격 하게 설계된 쏘프트웨 어 이 다. 범 용성 이 있으 
며 강력하고 사용하기 쉽다는 우점이 내부의 복잡성을 은폐하고 있다. 체계의 안정성과 
미리 갖추어 진 보안기능은 이 조작체계가 기업관련의 사용자들도 만족시키게 한다. 물 
론 많은 쏘프트웨 어 개 발자들도 같은 리 유로 하여 Windows 2000 을 리 용하고 있다. 

이 책 은 독자들에 게 Windows 200◦ 프로그람을 작성 하는 방법 을 가르치 기 위 한 도서 
로서 기초적 인것으로부터 시작하여 중요한 문제들에 이르기까지 모두 포괄하고 있다. 또 
한 고급한 프로그람작성 기술들도 많이 소개 한다. 

만일 독자들이 Windows 프로그람을 작성해 본 경험이 없다면 이 책을 제 1 장부터 
차례로 읽어 나가야 한다. 다음 장의 내용은 앞장에서 설명한 내용을 기초로 하여 전개 
되여 있기때문에 부분적으로 뛰여 넘으며 읽어서는 안된다. 

Windows 95 등의 다른 판본의 Windows 프로그람을 작성해 본 경험이 있다면 이 
책을 보다 빨리 읽 어 나갈수 있을것 이 다. 그러 나 기초지식을 설명하는 장들에는 주의를 
돌려야 한다. 그것 은 Windows 2000 과 다른 판본의 Windows 사이 에 중요한 차이 점 이 
일부 존재하기때문이다. 

이 책들 리용하는데 필요한 프로그람작성의 기초지식 

이 책을 효과적 으로 리용하려면 C 혹은 C++ 에 의한 프로그람작성경험 이 필요하 
다. 그것은 C 혹은 C++ 가 Windows 2000 의 프로그람개 발언어 이 기때문이 다. 만일 C 
나 C++ 에 대한 지식의 부족을 느낀다면 기초지식의 기반을 공고히 하는데 시간을 투 
하해 야 한다. 

Windows 2000환경에서 프로그람을 개발하는것은 구조체와 공용체，지시자 등을 활 
용하는것으로 된다. 이 러한것들에 습관되여 있지 않다면 Windows 2000 프로그람을 작 
성하는것이 곤난하다. 
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이 책을 리용하는데 필요한 쏘프트웨어 

이 책에서 제시하는 원천코드들을 번역하려면 Windows 2000 프로그람을 작성하는 
기능을 가진 C++ 번역프로그람이 있어야 한다. 이 책에서는 Microsoft Visual C++6.0 에 
서 원천코드의 번역결과를 확인하였다.(일부 프로그람을 제외하고는 Borland C++ 
Compiler 5. 5 로도 번 역 할수 있 다) 

이 책 의 실례 들은 표준적 인 C++ 의 문법 규칙 에 맞추어 작성한 프로그람들이 므로 파 
일이름의 확장자로 .cpp 를 사용하여야 한다. 그러나 거의 모든 부분에서 C++ 의 C 언어 
기능만이 사용되고 있으므로 응용프로그람을 C 나 C++ 의 임의의 언어로 작성한다고 해도 
이 책의 원천코드들을 그대로 사용할수 있다. 

이 책의 프로그람을 번역할 때에는 Windows 프로그람을 작성하기 위한 체계설정을 
리용하여 야 한다. 그러 나 MFC 와 같은 클라스서고의 지원은 선택하지 말아야 한다. 즉 
Microsoft Visual C++ 를 사용한다면 새 로운 프로젝 트에서 Win32 Application 을 선택해 
야 한다. 
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제 1 장 


Windows 2000 으 I 기초 


Windows 2000 은 Microsoft 의 최 신판 32 bit 조작체 계 이 다. 이 책 에서 
는 Windows 2000 프로그람을 작성 하는 방법 을 서 술한다. 프로그람작성 의 
기초도서 인 이 책은 Windows 2000 의 기능들중에서 프로그람작성과 직접 
관련이 없는 부분에는 많은 폐지를 할당하지 않는다. 그대신 될수록 빨리 
Windows 2000 프로그람을 작성 할수 있도륵 실 리적 인 방법 을 주고 있다. 
우선 Windows 2000 프로그람을 파악하기 위 한 첫 단계 로서 Windows 
2000 의 주요기 능들에 대 하여 설 명한다. 

Windows 2000 은 매우 거대하고 복잡한 조작체계 이므로 한권의 책에서 
그의 모든 기능을 설명할수는 없다. 그러므로 광범히 리용되는 기능들과 중 
요한 새 기 능들중에 서 모든 Windows 2000 프로그람에 공통적 인 항목들만을 
취 급하며 모든 Windows 2000 프로그람작성 자들이 반드시 알아야 할 내 용들 
을 포괄한다. 이 책 은 중요한 조작체 계 인 Windows 2000 을 보다 깊 이 학습 
하기 위한 기초지식을 주도록 서술되 여 있다. 
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Windows 2000 이란 무엇인가 ? 


Windows 2000 은 Windows NT 에 기 초하고 있는 Microsoft 의 본격 적 인 32bit 
Windows 가동환경 (Platform) 이지 만 그보다 한 단계 더 발전한 조작체 계 이 다. NT 기 술 
에 기초하고 있지만 Windows 2000 은 새롭게 고쳐 설계 하고 코드도 고쳐 써 NT 에 비 
하여 보다 강력 하면서 도 유연성 을 가지 게 되 였 다. 례하면 내 장된 보안기 능과 확장된 망 
기능 및 최신하드웨어에 대한 대응 등 새로운 기능들을 가지고 있다. Windows 2000 은 
Windows 를 21 세기에로 인도하는 조작체계이다. 

Windows 2000 에 는 다음과 같은 네 가지 환경 이 있 다. 

• Windows 2000 Professional 

• Windows 2000 Server 

• Windows 2000 Advanced Server 

• Windows 2000 Datacenter Server 

이 책의 내용은 우에서 서술한 모든 환경에 대응하고 있다. 기본적 인 프로그람작성 
수법 은 모든 환경 에 서 다 같다. 많은 리용자들은 프로그람을 작성 하거 나 검 사하는데 
Windows 2000 Professional 을 사용 하 고 있 다 . Windows 2000 Professional 은 
Windows NT 4.0 Workstation 의 갱 신판이 며 결과적 으로는 말단사용자를 위 한 
Windows 2000 이 다 . 

Windows 2000 은 완전한 32bit 조작체계이다. 이것은 Windows 95 에서와 같이 
32bit 와 16bit 가 뒤섞 인 코드를 사용할수 없다는것을 의미한다. 순수한 32bit 체계를 
제 공하는것 으로 하여 Windows 2000 에 는 낡은 조작체 계 를 피 롭혀 오던 결 함이 나 문제 점 
들이 배제되였다. 

또한 Windows 2000 전용으로 서술된 프로그람만이 아니 라 Windows 況 /98/NT 용 
프로그람의 대부분을 실행 할수 있 다. 그밖에 도 Windows 2000 은 DOS 프로그람을 비 롯 
한 종래 의 16bit 프로그람도 실 행할수 있 다. Windows 2000 은 실 행 하는 프로그람에 알 
맞는 적절한 환경을 자동적으로 제공해 준다. 례를 들어 DOS 프로그람을 실행하려는 경 
우에는 Windows 2000 이 16bit DOS 의 가상기계와 프로그람을 실행하기 위한 지 령대기 
상태창문을 자동적으로 작성해 준다. 

Windows 2000 은 C2 보안준위 에 해 당한 보안기 능을 실현 하였 다. 이 보안준위 는 암 
호에 의한 등록가입 (Log on), 소유권에 의 한 자원호출제 한과 동작내용을 기록하는 기능 
(Log) 을 제공한다. 기억기는 사용되기전에 초기화되며 프로그람에 의하여 사용되는 기 
억기는 보호되여 다른 프로그람의 영향을 받지 않는다. 따라서 한 프로그람이 다른 프로 
그람을 파피하거나 그의 내용을 참조할수 없도록 되여 있다. 
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응용프로그람대면부 


프로그람작성 자의 관점 으로는 Windows 2000 이 프로그람사이 의 대 면부 (Interface) 
를 정의하고 있는것처럼 보인다. 모든 응용프로그람은 이 대면호출을 통하여 Windows 
2000 과 련계 를 취 한다. Windows 2000 대 면호출은 조작체 계의 기 능을 호출하도록 정의되 
여 있는 일련의 함수모임으로 되 여 있다. 이 함수들을 통털어 응용프로그람대면부 (API : 
Application Programming Interface ) 라3- 한다. 

API 는 수백개의 함수들을 포괄하고 있으며 응용프로그람은 기억기의 할당과 화면에 
대한 출력 및 창문의 작성과 같은 조작체계가 가지고 있는 기능이 펼요될 때 API 를 호출 
하여 리 용한다. API 가운데 는 도형 장치 대 면부 (G 幻 T : Graphics Device Interface ) 라는것 이 
있다. 이것은 장치에 의존하지 않는 도형을 제공하는 Windows 기능의 일부이다. 

자주 사용되 는 API 에 는 기 본적 으로 術:/ 7 光과 術: n 然의 두가지 부류가 있 다. Winl6 
은 낡은 16bit 판 API 이 다. Win32 는 현재 주류로 되 고 있는 32bit 판 API 이 다. Winl6 
은 Windows 3.1 에서 사용되였다. Windows 2(X)0 프로그람은 Win32 를 사용한다. 일반 
적 으로 Win32 는 Winl6 의 확장묶음이라고 한다. 사실 많은 함수들은 꼭 갈으며 사용법 
도 갈다. 

그러 나 기능이 나 사용법 이 류사하다고 하여도 Winl6 과 Win32 에 는 기본적 으로 두 
가지 큰 차이가 있다. 첫번째 차이는 Win32 가 32bit 의 련속적 인 주소공간을 지원하고 
있는 반면에 Winl6 은 16bit 토막을 사용하는 기 억기모형을 지 원한다는것 이 다. 이 차이는 
Winl6 에서 16bit 파라메터를 사용하고 있는 부분에 Win32 에서는 32bit 파라메터를 사용 
한다는것을 의미 한다. 

두번째 차이는 Win32 에는 스레드 (Thread) 에 의 한 다중과제 , 보안 및 기 타 Winl6 
에는 없는 확장기능을 지원하는 API 가 있다는것 이 다. 만일 Windows 프로그람을 작성 
해 본 경험이 없다면 이 차이를 인식할 필요는 없을것이다. 그러나 이전에 작성했던 
16bit 의 코드를 Windows 2000 에 이 식 하려 고 한다면 매 API 함수에 주는 파라메 터 들을 
충분히 확인해 보아야 한다. 

참고 : Winl 6 API 는 DOS 준위에서 동작하는 Windows 3. 1 응용프로그 람과의 호환성때 
문에 아직까지 사용되고 있 다. 그러나 Windows 2000 프로그람에서는 반드시 Win 32 API 
를 사용해야 한다. 
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Windows 2000 프로그람작성법 


동적련결서고 


Win32 의 API 함수는 동적련결서고 (DLL : Dynamic Link Library ) 라고 부르는 파 일 
에 들어 있다. DLL 의 기능은 매개 프로그람이 실행될 때 호출된다. API 함수는 DLL 에 
재배 치가능한 형식 으로 넣 어 져 있다. API 함수를 호출하는 프로그람을 번역하는 시점 에 
서 련결프로그람은 프로그람의 실행 (EXE) 파일에 함수코드를 써넣지 않는다. 그대신에 
DLL 의 이름이나 함수이름 등 함수의 적재정보만을 써넣는다. 

프로그람을 실행하면 필요한 API 코드가 Windows 2000 에 의 하여 적재된다. 이 런 
방식 에 의하여 매 프로그람에 API 코드를 포함시키거 나 그것을 디스크에 보관할 필요가 
없어지게 된다. API 코드는 실행 시 에 프로그람이 기 억기 에 적재될 때 추가된다. 

DLL 을 리용하는데 는 매 우 중요한 여 러 가지 우점 이 있 다. 

첫째 로，사실상 모든 프로그람이 API 함수를 사용하는것 으로 되므로 DLL 이 차지 하 
는 디스크공간을 절약할수 있다. 만일 디스크에 넣어 진 매 프로그람의 EXE 파일에 
API 함수가 직 접 추가된다면 대 량의 중복된 코드로 하여 디 스크공간이 소비 되 게 된다. 

둘째 로, Windows 2000 자체의 갱 신이 나 확장을 DLL 파일을 변경 하는것만으로 간단 
히 실현할수 있으며 이미 작성된 프로그람들을 다시 번역할 필요는 없다. 

셋째로， DLL 을 사용함으로서 다른 종류의 조작체계의 모의를 쉽게 실현할수 있다. 


다중스레드에 의한 다중과제의 지원 


Windows 2000 은 "중균八 T// 조작체계이다. 이것은 두개이상의 프로그람을 동시에 실 
행할수 있다는것을 의미한다. 물론 CPU 가 한개 인 체 계 에서는 개 개의 프로그람이 CPU 
를 공유하므로 그것들을 완전히 동시에 실행할수는 없다. Windows 2000 은 두개 이상의 
CPU 를 장비한 콤퓨터 에서도 동작한다. 이 경우에는 프로그람을 완전히 동시 에 실행할 
수 있다. 그러나 작성한 프로그람이 실행되는 름퓨터의 종류를 언제나 확인할수 있는것 
은 아니므로 동시실행은 항상 고려해야 할 과제정도에서 생각하는것이 좋다. 

Windows 2000 은 프로세스준위 및 스레드준위 두 종류의 다중과제처리를 지원한다. 
프로 {// 스란 실행중의 프로그람을 말한다. Windows 2000 은 프로세스준위의 다중과제를 
지원하고 있으므로 동시 에 한개 이상의 프로그람을 실행 할수 있다. Windows 2000 이 지 
원하는 프로세스준위의 다중파제는 고전적 인 수법 이 다. 

Windows 2000 이 지 원하고 있는 두번째 다중과제 수법 은 스레 드준위 의 다중과제 처 리 
이 다. 스레드린: 관리 와 실행 이 가능한 코드단위 이 다. 이 이 름은 [실행줄 (Thread of 
execution)] 이 라는 고찰법 으로부터 붙여 진것 이 다. 모든 프로세 스는 적 어도 하나의 스 
레 드를 가전다. 그러 나 Windows 2000 프로세스는 여 러 개의 스레 드를 가지는것 이 보편적 
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이 다. 

Windows 2000 이 스레드를 다중과제로서 실행할수 있다는것과 개개의 프로세스가 
한개이상의 스레드를 가지고 있다는데로부터 한개의 프로세스는 동시에 실행되는 두개이 
상의 스레 드를 가질 수 있게 된 다. 그러 므로 Windows 2000을 사용하면 프로그람을 다중 
과제로 실행할수 있을뿐아니라 한 프로그람에서 매 부분을 다중과제로 실행할수도 있다. 
그러나 이러한 우월성을 살러자면 상당히 수준 있는 프로그람을 작성하여야 한다. 


여러가지 과일체계 


Windows 2000에 대 하여 또 한가지 알아 두어 야 할것 은 아래 에 표시 한 여 러 가지 파 
일체계를 지 원한다는것 이 다. 


• FAT (File Allocation Table ) 

• FAT 32 (FAT 를 32 bit 로 확장한것 ) 

• NTFS (NT File System ) 

凡 4 ：T 파일체계는 DOS 용으로 설계된 낡은 파일체계 이 다. 이 파일체계는 장기간에 
걸 쳐 사용되 고 널 리 보급되 였 다. 그러 나 FAT 파일 체 계 는 DOS 와의 호환성 을 유지한다 
는 리 유로 하여 용량에 제 한이 있다. FAT 의 제 한성은 凡47그? 에 의 하여 개선되 였으며 
FAT 32 는 대 용량의 디 스크를 지 원한다. NTFS 는 Windows NT 전용으로 설계 되 였 으며 
Windows 2000 에 서 개 량이 가해 진 수법 이 다. 八^ T /정에 는 보안기 능 등 수많은 우점 이 있 
다. 어느 파일체계를 사용하여도 문제가 없다. 
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제 2 장 


Windows 2000 프로그람 
작성의 기초 


이 장에서는 Windows 2000프로그람작성의 기초를 학습한다. 이 장의 
첫째 목적은 프로그람이 Windows 2000 과 련계를 취하는 방법과 모든 
Windows 2000 응용프로그람에 공통되는 규칙을 학습하는데 있다. 둘째 
목적은 다른 장들에서 작성하는 Windows 2000 프로그람의 시초로 되는 
골격코^를 작성하는것 이 다. 모든 Windows 프로그람에는 공통된 부 
분이 있으며 이것은 이 장에서 작성하게 되는 응용프로그람의 골 
격 코드에 들어 있 다. 

먼저 Windows 2000 프로그람을 작성 하기 위한 두가지 방법 을 설 명 
해 보자. 



제 2 장. Windows 2000프로그람작성 의 기 초 


Windows 2000 프로그람들 작성하기 위한 두가지 방법 


Windows 2000 프로그람을 작성 하는데 는 두가지 방법 이 있 다. 첫 번째 방법 은 Win 32 
가 제공하는 API 함^% 리용하는것 이 다. 이 방법 에서는 프로그람에서 API 를 직접 러용 
하며 따라서 Windows 2000프로그람의 모든 요소를 상세 히 서 술하게 된 다. 

두번째 방법은 API 함수들을 은페시킨 C ++ 클라스서고를 사용하는것 이 다. 지금까지 
널리 보급되여 온 Windows 프로그람을 위 한 클라스서고는 MFC (Microsoft Foundation 
Classes ) 이 다. MFC 나 Windows 용의 다른 클라스서 고들은 여 러 가지 측면에서 많은 도 
움을 주는 강력한 개 발도구이 다. 그러 나 이것들은 API 를 사용한 Windows 프로그람작 
성방법의 기초를 명백히 알지 못하면 원만하게 사용할수 없다. 그 리유는 다음과 갈다. 

첫째로, 모든 Windows 프로그람에 공통되는 기본적 인 구성방식 이 있다는것 이 다. 
MFC 는 이 구성방식의 대부분을 은패하고 있다. Windows 구성방식에 대한 지식은 장 
기적 인 프로그람작성을 계 획하고 있다면 중요한 지식으로 된다. 례하면 이 지식 이 
Windows 프로그람에 대한 오유수정을 쉽게 해춘다. 

둘째로， API 를 사용함으로써 프로그람의 동작을 세밀하면서도 완전하게 조종할수 
있기 때문이다. 

셋째로，모든 Windows 2000프로그람개발환경들이 API 에 의한 개발을 지원하고 있 
기때문이다. API 의 지식은 여러가지 측면에서 리용할수 있다. 

넷째 로， API 를 러 용하여 Windows 2000 프로그람을 작성 할수 있으면 MFC 나 다른 
클라스서고도 쉽게 정통할수 있기때문이 다. 즉 API 를 리용한 프로그람작성방법을 모르 
는 사람은 우수한 Windows 프로그람작성 자라고 말할수 없다. 

Windows 2000 프로그람의 외형과 조작성 


Windows 2000 (Windows 전반)의 목적에는 사전에 어떤 련습이 없이도 누구든지 체 
계앞에 앉으면 간단히 응용프로그람을 조작할수 있 어 야 한다는 큰 전제 가 있 다. 

이로부터 Windows 는 통일적 인 대면부를 사용자에게 제공한다. 리상적으로는 하나 
의 Windows 프로그람을 조작해 본 경험이 있으면 다른 모든 Windows 프로그람을 조 
작할수 있도록 되여야 할것이다. 

물론 대다수의 실제 프로그람들은 그것을 효과적으로 리용하려면 약간한 훈련이 필 
요하다. 그러나 적어도 이 훈련의 목적은 사용자가 프로그람을 어떻게 조작하는가가 아 
니라 프로그람자체의 약간한 기능을 파악하는데 있다. 사실 Windows 응용프로그람코드 
의 대부분은 사용자대면부% 지원하기 위한것으로 되 여 있다. 
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Windows 2000 프로그람작성 법 


Windows 2000 에서 동작하는 모든 프로그람은 창문형식의 대면부를 자동적 으로 제 
공하는것이 아니라는것을 알아야 한다. Windows 는 일관성을 주장하기 위한 환경을 제 
공하지 만 그것 을 강요하는것은 아니 다. 례하면 표준적 인 Windows 형 식의 대 면부를 구 
성 요소로 하지 않는 Windows 프로그람을 작성 할수도 있 다. 

Windows 형식의 프로그람을 작성하려면 이 책에서 설명하는 기술을 리용하여 정확 
한 수법에 따라야 한다. Windows 를 사용하도록 서술된 프로그람만이 일반적 인 
Windows 프로그람의 외형과 조작성을 가질수 있다. 

기 본적 인 Windows 설계의 기 본원칙 을 무시하려는 생각이 있다면 그렇게 해 야 할 
리 유가 필요하다. 왜 냐하면 그러 한 프로그람은 사용자대면부를 통일한다는 Windows 가 
큰 전제 로 내세우고 있는 목적을 무시하는것 으로 되기때문이 다. 일반적 으로 Windows 
2000 응용프로그람을 작성하는 경우 표준적인 Windows 형식의 규칙과 설계수법에 따라 
야 한다. 

여기서는 Windows 2000 응용프로그람의 조작성을 결정하는 중요한 요소들을 몇 가지 
보기로 하자. 

탁상모형 

약간 례외는 있지만 창문형식의 사용자대면부의 목적은 화면에 탁상면과 꼭같은 환 
경을 제공하는것이다. 탁상에는 여러가지 종류의 서류가 있고 그것들이 겹놓일수 있다. 
현재 보이 는 제 일 꼭대 기 의 서 류밑 에 는 다른 서 류가 있다. Windows 2000 에 서 탁상면 
에 해당한것은 현시장치의 화면이다. 다종다양한 서류에 해당한것은 화면상의 창문이 
다. 탁상에서는 서류의 위치를 이동시킬수 있을뿐아니라 임의의것을 제일 우에 놓을수 
있고 눈으로 볼수 있는 범위 를 확대할수도 있다. Windows 2000 은 창문에 대 해서 같 
은 조작을 할수 있도록 되 여 있 다. 창문을 선택하여 그것 을 현재 의 창문으로 할수 있 
다. 이것은 그 창문을 다른 창문우에 놓는다는것 을 의 미한다. 창문의 크기 를 크게 하 
거나 작게 할수도 있으며 화면상에서의 위치를 이동시킬수도 있다. 즉 Windows 는 
탁상우에서의 조작과 같은 방법으로 화면을 조작할수 있다. 일반적 인 프로그람에서 이 
러한 조작들이 가능하다. 

마우스 

다른 판본의 Windows 에서와 같이 Windows 2000 에서도 대부분의 조작과 선택 및 
화면작업 등에 마우스를 사용한다. 물론 건반도 사용할수 있지만 Windows 에서는 마우 
스를 사용하는것이 더 편리하다. 그러므로 앞으로 작성하는 프로그람에서도 입력장치로 
될수록 마우스를 지원해 야 한다. 차림표선택, 흘림띠의 조작 등을 포함한 일반적인 조작 
에 마우스가 자동적으로 지 원된다. 
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아이콘，비트매프 및 도형 

Windows 2000 에 서 는 아이콘，비트매프 맣 기 타 종류의 도형을 사용할수 있 다. 아 
公/콘은 어떤 조작，자원 또는 프로그람을 상징적으로 나타내는데 사용되는 작은 그림 
기 호이 다. 비 트매 프는 사용자에 게 정 보를 간단하면서 도 재 빠르게 전달하기 위하여 사 
용되 는 4 각형 의 도형 이 다. 비 트매 프가 차림 표의 요소로 사용되 는 경 우도 있다. 
Windows 2000 은 직선，4 각형, 원 등을 그리는 기능을 비롯해서 수많은 도형기능을 
지원한다. 이러한 도형기능들을 적절히 사용하는것은 Windows 프로그람을 완성하기 
위한 중요한 고리 이 다. 

차림표，조종체, 대화칸 

Windows 는 사용자의 입력을 받아 들이기 위한 여러가지 표준적인 항목들을 제공 
한다. 그것들은 차림표와 다양한 종류의 조종체 말 대 화칸 등이 다. 간단히 말해서 차림 
표는 사용자가 선택할수 있는 추가선택항목들을 표시한것이다. 차림표는 Windows 프로 
그람의 표준항목이므로 API 에 차림표선택기능이 들어 있다. 따라서 프로그람에서 차림 
표에 대한 조작을 상세하게 서술할 필요는 없다. 

조종체는 특정한 형식으로 사용자와의 대화를 가능하게 하는 특수한 창문이 다. 례를 
들어 누름단추, 흘림띠 , 편집칸, 검 사칸 등이 있다. 차림 표의 사용과 마찬가지 로 
Windows 에 정의되여 있는 조종체의 조작은 거의 자동화되여 있다. 상세한 조작을 프 
로그람에 서술하지 않고 조종체를 사용할수 있다. 

대화칸은 차림표보다 복잡한 조작성을 응용프로그람에 제공해 준다. 례하면 파일 이 
틈을 입력하는데 대화칸을 사용할수 있다. 대화칸은 주로 조종체를 배치하기 위하여 사 
용한다. 대체로 차림표형식을 제외한 입력은 대화칸으로 실현한다. 

창문의 구성요소 


Windows 2000 프로그람구조를 설명하기 에 앞서 창문의 구성요소들의 이름을 설명 해 
보자. (그림 2-1) 

모든 창문에는 창문의 테두리를 표시하는 경계선이 있으며 그것을 사용하여 창문의 
크기를 변경할수 있다. 창문의 웃부분에는 여 러 개의 요소가 있다. 왼쪽 웃모서 리 에는 乂// 
계차림표아이콘이 있다. 이 아이 콘을 찰칵하면 체 계차림 표가 현시 된다. 체 계차림 표아이 콘 
의 오른쪽에 는 창문의 제 목이 있 다. 오른쪽끝에 는 최 소화단추，최 대 화단추 및 닫기단추 
가 있다. 의로 I 자구역은 프로그람이 실제로 사용하는 부분이다. 대부분의 창문에는 창문 
에 표시되는 본문 등을 흐르게 하기 위한 수평홀림띠와 수직홀림띠가 있다. 
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제계차림표아이콘 



! 계선 


의뢰자구역 


그림 2-1. 표준적인 창문의 구성요소 

Windows 와 프로그람이 정보를 주고받는 방법 



이 전의 조작체 계 와 프로그람들에 서 는 조작체 계 와의 련계 를 개 시 하는것 이 프로그람쪽 
이였다. 례하면 DOS 프로그람에서 입력이나 출력을 요구하는것은 프로그람이다. 결국 
고전적방식 으로 서 술된 프로그람은 조작체 계 를 호출하며 조작체 계 가 프로그람을 호출하 
지는 않는다. 

그런데 Windows 에서는 완전히 다른 형식이 리용된다. 프로 그람을 호출하는것은 
Windows 이다. 이것은 《프로 그람은 Windows 가 보내오는 통보문을 받는다》는것으로 
실현된다. 통보문은 Windows 가 호출하는 특수한 함수에 의 하여 프로 그람에 전송된다. 
통보문이 보내지면 프로 그람이 그 내용에 따라서 처리를 진행한다. 

통보문에 응답할 때 몇가지 API 함수를 호출할수도 있지만 주도권을 가지고 있는것 
은 어 디까지나 Windows 이 다. 이것 이 Windows 2000 을 비롯한 모든 Windows 프로그 
탐에서 리 용하고 있는 통보문에 의 한 통신방식이 다. 

Windows 2000 이 프로그람에 보내는 통보문에 는 여 러 가지 종류가 있다. 례 하면 프 
로그람창문에 서 마우스를 찰칵할 때 마다 프로그람에 마우스찰칵통보문을 보낸 다. 프로그 
람창문의 크기가 변경되면 또 다른 통보문을 보낸다. 입력초점을 가진 프로그람에서 건 
반이 눌러울 때마다 또 다른 통보문을 보낸다. 

한가지 명백히 알아 두어야 할것은 프로그람과 관련한 통보문들이 임의로 발송된다 
는것 이 다. 이 로부터 Windows 프로그람은 새 치 기 구동방식 의 프로그람과 류사하다고 말 
할수 있다. 즉 다음에 어떤 통보문을 받게 될지 미리 알수 없다. 
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Windows 2000 응용프로그람의 기 반 


WinMain( ) 

모든 Windows 2000 프로그람의 실행 은 竹公 iMa 切상함수의 호출로부터 시 작된 
다. (Windows 프로그람에는 main ( ) 함수가 없다.) WinMain ( ) 에는 응용프로그람에서 
사용되는 다른 함수와는 다른 여 러가지 특징 이 있다. 우선 WinMainC ) 함수는 WINAPI 
호출규약을 지 정하여 번 역하여 야 한다. 프로그람에 서 사용되 는 함수에 는 암시 적 으로 C 
의 호출규약이 사용되지만 이것을 다른 호출규약을 사용하도록 변경하여 함수를 번역할 
수도 있다. 

례 하면 자주 사용되 는 호출규약으로서 /싯5■公 1 L 호출규약이 있 다. 몇 가지 리 유로 하 
여 Windows 2000 이 WinMain ( ) 을 호출할 때 는 WINAPI 호출규약이 사용된다. 또한 
WinMainC ) 의 돌림값형은 옹근수형 ( int ) 형으로 되여야 한다. 

이식과 관련한 요점 : 낡은 16 bit 판 Windows 프로그람에서는 WinMainC ) 호출규약으로 
PASCAL 이 사용되였다. 이런 응용프로그람들을 Windows 2000 ^1 이식하는 경우 이것 
을 WINAPI 호출규약으로 변경하여야 한다. 


창문수속 (참문함수) 

모든 Windows 프로그람은 그 프로그람내부에서 가 아니 라 Windows 에 의 하여 호 
출되는 특수한 함수를 가질 필요가 있다. 이 함수를 일반적 으로 창문수속 혹은 창문함수 
라고 부론다. 이 함수를 통하여 Windows 2000 과 프로그람과의 련계 가 이 루어 진다. 

창문함수는 프로그람에 통보문을 보낼 필요가 있을 때 Windows 2000 에 의하여 호 
출된 다. 이 때 창문함수의 파라메터 에 통보문이 주어 진다. 모든 창문함수는 돌림 값형 으 
로서 LRESULTCALLBACK 를 지정 하여 선언된다. LRESULT 는 32 bit 의 부호 없는 옹 
근수형 이다. CALLBACK 는 이 함수가 Windows 로부터 호출된다는것을 나타낸다. 
Windows 용어에서는 Windows 로부터 호출되는 함수를 으/호함수라고 한다. 

이식과 관련한 요점 : 낡은 16 bit 판 Windows 코드에서는 창문함수를 LONG FAR 
PASCAL 형으로 정의하였다. Windows 2000 에 이식하는 경우에는 이것을 LRESULT 
CALLBACK 로 변경하여야 한다. 
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창문함수가 Windows 2000 이 보내는 통보문을 받으면 그 통보문에 의해 지시되는 
처리를 해야 한다. 전형적인 창문함수의 내부는 매개 통보문에 응답하도록 처리를 분기 
시키는 sw / fcA 문으로 구성된다. 

그러나 프로그람에 보내오는 통보문을 모두 처리할 필요는 없다. 왜냐하면 
Windows 2000 에 암시 적 인 처 리 를 의 뢰 할수 있기 때 문이 다. Windows 가 생 성 하는 통 
보문의 종류에는 수백가지가 있으므로 대부분의 통보문은 프로그람에서 처 리하지 않고 
Windows 에 맡기 는것 이 일 반적 이 다. 

모든 통보문은 32 bit 의 부호 없는 옹근수값이다. 또한 모든 통보문에는 통보문을 보 
충하는 몇 가지 정보가 부가되 여 있다. 

참문클라스 

Windows 2000 프로그람의 실행을 시작할 때는 처음에 창문클라스악 정의와 등록을 
진행 하여 야 한다. (여기서 콜라스타는 용어는 C ++ 클라스가 아니 라 단순히 양식 이 나 형식 
이라는 의미에서 사용된다.) 창문클라스를 등록할 때 windows 에 창문의 형식과 창문 
함수를 알려 준다. 그러나 창문콜라스를 등록하는것만으로는 창문이 작성되지 않는다. 
창문을 작성 하려면 앞으로 여 러단계 가 필요하다. 

롬보문순환고리 

이 미 설명 한바와 같이 Windows 2000 은 통보문을 보내 여 프로그람과 련계를 취 한다. 
모든 Windows 프로그람은 WinMain ( ) 함수내 에 통보문순환고리를 포함하고 있다. 

이 순환고리에서는 응용프로그람통보문대기렬에 쌓여 있는 통보문을 꺼 내여 그것을 
Windows 에 되 돌려 주면 Windows 가 그것 을 파라메터 에 넣 어 프로그람의 통보문함수 
를 호출한다. 이와 같은 방식은 통보문을 전달하는 수단으로서 모든 Windows 프로그람 
이 정 확히 동작하게 하는 방식 이 다. (이 방식 을 사용하는 리 유의 하나는 일정 짜기 프로그 
람 ( scheduler ) 가 CPU 시간을 할당하는데서 Windows 에 조종을 돌려 주는 편이 응용프 
로그람의 시 간구획 이 끝나기를 기 다리는것보다 더 합리적 이기때문이 다.) 

Windows 에서 사용하는 자료형 

Windows API 함수에 서 는 int 나 char 와 같은 표준적 인 ( VC ++ 자료형 을 사용하는 경 
우가 드물다. 그대 신에 Windows 에서 사용되는 대부분의 자료형은 竹 7 A 取幻兩 S .// 파일 
또는 그와 관련한 파일안에 형정의 (分取 ec / ei ) 문으로 정의된 특수한 자료형으로 되여 있 
다. 이 파일은 Microsoft (및 Windows 용 C ++ 번역 프로그람제 작자) 에 의 하여 제공되는 
것이며 모든 Windows 프로그람에 포함되여 있어야 한다. 

자주 사용되는 자료형으로서 HANDLE , HWND , BYTE , WORD , DWORD , UINT , 
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LONG , BOOL , LPSTR , LPCSTR 등이 있 다. HANDLE 은 손잡이로 A 사용되 는 32 bit 
의 부호 없는 옹근수값이다. 손잡이의 형식에는 여러가지 종류가 있다. 이것들은 모두 
HANDLE 과 같은 크기를 가진다. 손잡이 란 어떤 자원을 식 별하기 위 한 단순한 값이 다. 
례하면 HWND 는 창문의 손잡이 로서 사용되 는 32 bit 의 부호 없는 옹근수이 다. 손잡이 를 
표시하는 자료형 은 모두 H 로 시 작하는 이 름으로 되 여 있 다. 

BYTE 는 8 bit 의 부호 없는 옹근수이 며 WORD 는 16 bit 의 부호 없는 옹근수이 다. 
必찌幻反 D 와 UNIT 는 32 bit 부호 없는 옹근수이고 LONG 은 32 bit 의 부호 있는 옹근수이 다. 

그러고 BOOL 은 옹근수이며 참과 거짓을 나타내는데 사용한다. 그러나 표준적 인 
C ++ 의 bool 과는 달리 BOOL 에 는 모든 옹근수값을 보관할수 있 다. LPSTR 는 문자렬 에 
대 한 지 시 자이 며 LPCSTR 는 문자렬 에 대 한 상수 ( const ) 지 시 자이 다. 

지금까지 설명한 기본적인 자료형외에도 Windows 2000 에 독자적으로 정의되여 있 
는 여 러가지 구조체가 있다. 륜곽코드에서 사용하는 구조체는 MSG 와 WNDCLASSEX 
이 다. MSG 구조체 는 Windows 2000 통보문을 보관하기 위 한것 이 고 WNDCLASSEX 구조 
체는 창문콜라스를 정의할 때 사용되는것 이 다. 이 구조체들에 대 해서는 이 장의 뒤부분 
에 서 상세 히 설 명한다. 

이식과 관련한 요점 : UINT 는 Windows 2000프로그람을 번역할 때는 32 bit 의 부호 없 
는 옹근수로 되며 16 bit 의 Windows -2^# 번역 할 때는 16 bit 의 부호 없는 옹근수로 
된다. 낡은 응용프로그람을 Windows 2000 에 이식하는 경우에는 변경이 필요하다. 


Windows 2000 의 골격코드 


이 제 한 걸 음씩 최 소한의 Windows 2000 응용프로그람을 작성 해 보자. 모든 
Windows 2000 프로그람에 는 공통적 인 부분이 있 다. 여 기 에 서 는 펼수적 인 기 능과 요소를 
가진 최 소한의 Windows 2^況 음용프로그람의 골격코드를 작성 하기 로 한다. 

Windows 프로그람작성 분야에서는 응용프로그람의 골격 이 재 리 용된 다. 최소한의 프 
로그람의 크기 가 다섯 행 정 도인 DOS 프로그람과는 달리 Windows 2000 에 서 는 그 크기 가 
50 행정 도로 된다. 이때 문에 Windows 프로그람작성 에는 응용프로그람의 골격 이 재 리용 
된 다. 

최소한의 Windows 2000 프로그람은 WinMainC ) 과 창문함수를 가진것으로 된다. 
WinMain ( ) 함수에서는 다음의 순서로 처리를 진행한다. 

• 창문클라스에 기초하여 창문을 작성한다. 

• 창문콜라스를 정의한다. 
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• 창문콜라스를 Windows 2000 에 등록한다. 

• 창문을 표시한다. 

• 통보문순환고리의 실행을 개시한다. 

창문함수는 프로 그람의 동작에 관계되는 모든 통보문에 응답해 야 한다. 이 륜곽코드에 
서는 창문을 표시하는것외에는 아무것도 하지 않 으므로 응답해야 할 통보문은 사용자가 
프로 그람을 완료한다는것 을 응용 프로 그람에 알리 는것 만으로 된 다. 

자세한 설명 을 하기 에 앞서 아래의 프로그람을 실행해 보자. 이것은 최소한의 
Windows 2000 프로그람골격 이 다. 이 골격 코드는 제 목, 체 계 차림 표단추, 최 소화단추，최 
대 화단추，닫기단추를 가진 표준창문을 표시 한다. 따라서 이 창문은 최 소화, 최 대 화, 이 
동，크기변경 및 완료기능을 가지게 된다. 

실 례 2-1. Skel 프로그람 


// Windows 2000 의 최 소골격 코드 


#include 〈 windows. h> 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 

char szWinName[] = n MyWin，，; // 창문들라스의 이름 

int WINAPI WinMain (HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg; 

WNDCLASSEX wcl; 

// 창문들라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ； 


wcl.hlnstance = hThisInst ； // 실체의 손잡이 

wcl. IpszClassName = szWinName ； // 창문콜라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 암시적형식 
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wcl.hlcon = LoadIcon(NULL, IDI—APPLICATION) ; // 큰 아이론 
wcl.hlconSm = NULL ； // 큰 아이콘에 대웅한 작은 아이콘을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 

wcl.IpszMenuName = NULL ； // 몰라스차림표는 없다 . 
wcl.cbClsExtra = 0 ； // 보조기억기령역은 필요 없다 . 

wcl. cbWndExtra = 0 ； 

// 창문의 배 경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject (WHITE_BRUSH) : 

// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문콜라스를 등록하였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문클라스의 이름 
"Windows 2000 Skeleton", // 형식 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 한다 . 
CWJJSEDEFAULT, // 창문의 너 비는 Windows 가 결정한다 . 
CW_USEDEFAULT, // 창문의 높이는 Windows 가 결정 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

); 


II 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) : 
UpdateWindow (hwnd) : 


// 통보문순환고리를 작성 한다 . 
while (GetMessage (&msg, NULL, 0, 0)) 
{ 
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TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage (&msg) : // Windows 2000 에 조종을 돌려 준다 . 

} 

return msg.wParam ； 


/* 이 함수는 Windows 2M0 으로부터 호출되며 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 

WPARAM wParam, LPARAM IParam) 

{ 

switch (message) { 

case WM_DESTROY: // 프로그람을 완료한다 . 

PostQuitMessage (0) ; 
break ； 
default ： 

/* 이 switch 문에서 지정되지 않은 통보문은 
Windows 양 )00 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam) : 

} 

return 0 ； 

} 

프로그람의 내 용을 차례 로 설명해 보자. 

우선 모든 Windows 2000 프로그람은 WINDOWS . H 라는 머 리 부파일 을 가져 야 한다. 
이 파일 및 그와 관련된 파일들에는 API 함수의 선언 , 다양한 자료형, 마크로 및 
Windows 2000 에서 사용되는 정의 가 포함되 여 있다. 례 하면 HWND 나 WNDCLASSEX 
등은 WINDOWS . H 및 그와 관련된 파일 들에 정 의 되 여 있 다. 

이 프로그람에서 사용하는 창문함수의 이름은 WindowFunc ( ) 이 다. 이 함수를 사 
용하여 Windows 2000 이 프로그람과 련계 를 취 하므로 역 호출함수로 된다. 

프로그람의 실행은 WinMain ( ) 으로부터 시작된다. WinMain ( ) 에는 4개의 파라메터가 
있다. hThisInst 와 hPrevInst 는 손잡이들이 다. hThisInst 는 현재 프로그람의 실체를 가리 
킨다. hPrevInst 는 마지막으로 기동된 같은 프로그람의 실체를 나타낸다. 

Windows 2000 은 다중과제처 리체계 이므로 어떤 프로그람의 실체를 동시에 여 러개 
실행시 킬수 있다. 그러나 Windows 2000 에서는 hPrevInst 값이 항상 NULL 로 되여 있 
다. IpszArgs 는 응용프로그람의 기동시 에 지정되는 지 령행파라메 터문자렬에 대 한 지시 자 
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이 다. Windows 2000 에서는 여기 에 프로그람의 이름을 포함한 완전한 지 령행문자렬을 
보관한다. flMnMxfe 에는 프로그람의 기동시에 프로그람을 어떠한 형식으로 표시하는가 
를 가리키는 값이 보관된다. 

WinMainC ) 안에서는 세개의 변수가 선언된다. hwnd 는 프로그람창문의 손잡이를 
보관하기 위 한 변수이 다. msg 는 통보문을 보관하기 위 한 구조체 형 변수이 며 wc/ 는 창 
문콜라스를 정의하기 위한 구조체형변수이 다. 

이식과 관련한 요점 : 이미 설명 한바와 같이 Windows 2000 프로그 람에서는 hPrevInst 
값이 항상 NULL 로 설정되여 있다. 16 bit 응용프로그람에서는 같은 프로그람실체가 실행 
중이면 hPrevInst 값이 NULL 로 되지 않는다. 이것은 16 bit 의 Windows 와 Windows 
2000의 기본적인 차이점의 하나이다. 16 bit 환경에서는 같은 프로그람의 여러개의 실체가 
창문들라스나 여러가지 자료를 공유한다. 이때문에 응용프로그람은 考/考/끼서 다른 실체 
가 실행중인가 아닌가를 아는것이 중요 하게 된다. 그러나 Windows 2000 에서는 매개 프 
로세스는 다른 프로세스와 독립 이므로 창문콜라스를 자동적으로 공유하지 않는다. 
Windows 2000 에 아직 hPrevInst 파라메터가 남아 있는것은 오직 호환성때문이다. 


참문클라스의 정의 

竹公 iMa/nO 에서 처 음으로 진행하는 두가지 처 리는 창문클라스를 정의 하고 그것 을 
등록하는것 이 다. 창문들라스는 WNDCLASSEX 구조체의 매 성 원들을 설정하여 정의한 
다. 매개 성원들은 다음과 같다. 


UINT cbsize； 

UINT style； 

WNDPROC lpfnWndProc； 
int cbClsExtra； 
int cbWndExtra； 
HINSTANCE hlnstance； 
HICON hlocn； 

HICON hlocnsm； 
HCORSOR hCursor； 
HBRUSH hbrBackground; 
LPCSTR IpszMenuName； 
LPCSTR IpszClassName; 


// WNDCLASSEX 구조체크기 

// 창문형 래 

// 창문함수주소 

// 클라스보조기억 기 령 역 

// 창문보조기억 기 령 역 

// 실체손잡이 

// 큰 아이론손잡이 

// 작은 아이콘손잡이 

// 마우스유표손잡이 

// 배 경색 

// 기본차림표의 이름 
// 창문클라스의 이름 
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륜곽코드에 서 볼수 있는것 처 럼 cbSize 에 는 WNDCLASSEX 구조체 의 크기 가 설 정 된 
다. hlnstance 에는 hThisInst 가 가리키는 현재 실체의 손잡이가 설정된다. 창문클라스 
의 이름은 IpszClassName 에 설정되며 여기 에서는 “ MyWin ” 이 라는 문자렬로 되 여 있다. 

창문함수의 주소는 lpfnWndProc 에 설정된다. 이 프로그람에서는 창문의 형식이 정의 
되여 있지 않다. 보조기 억기 령 역도 불필요한것 으로 되 여 있 다. 기 본차림 표도 지정 되여 있지 
않다. 대부분의 프로그람에는 차림표가 있지만 이 골격코드에서는 사용하지 않는다. 

모든 Windows 응용프로그람에 서 는 마우스유표와 응용프로그람아이 콘에 암시 적 형 태 
를 설정하여야 한다. 이 자원은 응용프로그람자체에서 작성할수도 있고 골격코드에서 하 
는것처 럼 미 리 갖추어 진 자원에서 선택할수도 있다. 어 느 경우에 나 자원의 손잡이를 
WNDCLASSEX 구조체 의 해 당한 성 원에 설정 하여 야 한다. 우선 아이 콘의 설정 방법 을 
설명해 보자. 

Windows 2000 응용프로그람은 두개의 아이콘을 가지 고 있다. 하나는 큰 아이콘이 고 다 
른 하나는 작은 아이콘이 다. 작은 아이콘은 응용프로그람이 최소화될 때 사용되며 체계 차림 
표의 위 치 에도 표시된다. 큰 아이콘은 응용프로그람을 이동 또는 복사할 때 표시된다. 

일반적 으로 큰 아이콘은 32 / 32의 비트매 프이며 작은 아이콘은 16 '次 16의 비 트매 
프이 다. 큰 아이 콘은 라는 API 함수로서 적재된다. 아래 에 이 함수의 선언을 

보여 주었다. 


HICON Loadlcon (HINSTANCE hlnst , LPCSTR IpszName ) : 


이 함수는 호출이 성공하면 아이콘의 손잡이 를 돌려 주며 실패하면 NULL 을 돌려 
준다. hlnst 에 는 아이 콘을 포함하는 모둘의 손잡이 를 설정하며 아이 콘의 이 름은 
IpszName 에 설정 한다. 그러 나 Windows 에 미 리 갖추어 진 아이콘을 사용하는 경우에 
는 첫 과라메 터 에 NULL 을 설정 하고 다음 파라메터 에 아래 에 준 마크로중의 어 느 하나 
를 설정한다. 


IDI_APPLICATION 

암시적인 아이콘 

IDI ERROR 

오유아이콘 

IDIJNFORMATION 

정보아이콘 

IDI QUESTION 

의문부호아이콘 

IDI WARNING 

감탄부호아이콘 

IDLWINLOGO 

Windows 의 략호 
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아이콘을 적재할 때 두가지의 중요한 문제를 고려해야 한다. 첫째로, 응용프로그람 
에서 작은 아이콘을 지적하지 않으면 큰 아이콘의 자원파일내용이 검사된다. 만일 자원 
파일안에 작은 아이콘도 들어 있다면 그 아이콘이 사용된다. 그렇지 않은 경우에는 작은 
아이콘이 요구될 때 큰 아이콘의 축소판이 사용된다. 작은 아이콘을 지정하지 않는 경우 
에는 골격코드에서 진행하는것처럼 hlconSm 값에 NULL 을 설정하여야 한다. 

둘째 로, 큰 아이 콘을 적 재 하는데 는 LoadlconC ) 을 사용하는것 이 일 반적 이 다. 
LoadlmageC ) 를 사용하면 다른 크기의 아이콘을 넣을수 있지만 이 책 에서는 대체로 
Windows 에 미 리 갖추어 진 아이콘만을 사용하고 있으므로 Windows 2000이 큰 아이콘 
과 작은 아이콘을 다 제공해 준다. 

마우스유표를 적재 하기 위 해서 LoadCursorC API 사용한다. 아래 에 이 

함수의 선언을 보여 주었다. 


HCURSOR LoadCursor (HINSTANCE hlnst , LPCSTR IpszName ) : 


이 함수는 호출이 성 공하면 유표의 손잡이 를 돌려 주며 실패하면 NULL 을 돌려 준 
다. hlnst 는 마우스유표를 포함하는 모둘의 손잡이 이 며 IpszName 에 는 유표의 이 름을 설 
정 한다. 그러 나 Windows 에 미 리 갖추어 진 유표를 사용하는 경 우에 는 첫 파라메터 에 
NULL 을 설정하고 두번째 파라메 터에는 마크로를 리용하여 미 리 갖추어 진 유표의 종 
류를 설정 한다. 아래 에 Windows 에 미 리 갖추어 진 유표종류의 몇 가지 를 보여 주었 다. 


IDC—ARROW 

표준화살표유표 

IDC—CROSS 

십 자유표 

IDC.HAND 

손모양유표 (Windows 2000 에 추가된것 ) 

IDCJBEAM 

I 자형 유표 

IDC—WAIT 

모래시계유표 


골격코드에서는 작성 할 창문의 배 경색 으로 환색을 지정 하며 그 붓 ( Brush ) 의 손잡이는 
GetStockObject ( ) 라는 API 함수에서 얻는다. 붓 ( Brush ) 이란 미리 정의된 크기, 색, 무 
뇌로 화면을 색칠하기 위한 자원이다. GetStockOb ject ( ) 는 붓, 펜，문자서체 등 여러가 
지 표준적인 화면객체의 손잡이를 엄는데 쓰인다. 아래에 함수의 선언을 보여 주었다. 


HGDIOBJ GetStockOb ject (int object ) : 

이 함수는 object 로 지정된 객체의 손잡이를 돌려 준다. 함수호출이 실패한 경우에 
는 NULL 을 돌려 준다. HGDIOBJ 라는 자료형 은 G 이 손잡이 를 의 미 한다. 아래 에 자주 
사용되는 미리 정의된 여러가지 붓을 보여 주었다. 
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배경형태 


BLACK_BRUSH 

검은색의 붓 

DKGRAY—BRUSH 

진한 회색의 붓 

HOLLOW.BRUSH 

가운데 구멍이 있는 붓 

LTGRAY BRUSH 

연한 회색의 붓 

WHITE_BRUSH 

흰색의 붓 


붓을 얻 으러 면 우의 마크로를 GetStockObject ( ) 의 파라메터 에 지 정 한다. 

창문클라스설 정 을 끝내 면 RegisterClassEx ( M 는 API 함수를 사용하여 창문클라스 
를 Windows 2000 에 등록한다. 아래 에 이 함수의 선언을 보여 준다. 


ATOM RegisterClassEx (CONST WNDCLASSEX *lpWClass ) : 

이 함수는 창문콜라스를 식 별하기 위 한 값을 돌려 준다. 이 란 WORD 에 별명 

을 붙인것이다. 매개의 창문클라스마다에 유일한 값이 주어 진다. lpWClass 에는 
WNDCLASSEX 구조체의 주소를 지정 한다. 


참문의 작성 

창문콜라스를 정 의 하고 등록이 끝나면 응용프로그람에 서 CreateWindowi API 
함수를 사용하여 그 클라스의 창문을 작성할수 있다. 아래 에 그 선언을 보여 주었 다. 


HWND CreateWindow ( 
LPCSTR lpClassName , 
LPCSTR lpWinName , 
DWORD dwStyle , 
int X , int Y , 
int Width , int Height , 
HWND hParent , 
HMENU hMenu , 
HINSTANCE hThisInst 
LPVOID IpszAdditional 


// 창문클라스이름 
// 창문제목 
// 창문형 태 
// 창문의 왼쪽 웃좌표 
// 창문의 크기 
// 어미창문의 손잡이 
// 기본차림표의 손잡이 
// 실체의 손잡이 
// 보충정보지시자 


륜곽코드를 보면 알수 있는바와 같이 CreateWindowC ) 의 파라메터 들은 암시 값 혹 
은 NULL 로 되 여 있 다 . 례 하 면 X , Y , Width , Height 에 는 많 은 경 우 
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CW - USEDEFAULT 를 설정 하는데 이때 Windows 2000 은 창문의 적 당한 크기와 위 치를 
결정해 준다. 

이 륜곽코드와 같이 어 미창문이 없는 경 우에 는 hParent 에 NULL 을 설정한다. 
( HWND—DESKTOP 를 설정 해도 같다. ) 창문에 기 본차림 표가 없든가 창문클라스에 의 하 
여 정의되는 기본차림표를 사용하는 경우에는 hMenu 를 NULL 로 한다. (hMenu 에는 
다른 사용방법 도 있다.) 이 경 우와 같이 만일 보충정 보가 필요 없으면(많은 경 우 필요 
없 다. ) IpszAdditional 을 NULL 로 한다. (LPVOID 형 은 void *를 가러 킨다. 례 를 들면 
LPVOID 가 void 형 에 대 한 long 지 시 자를 대 신하여 쓰인다. ) 

나머지 4 개의 파라메터는 프로그람에서 적 당히 설정 해 야 한다. 우선 lpszCla 況 name 
에 창문클라스의 이름(창문클라스등록시에 지정한 이름)을 설정한다. IpszWinName 에는 
창문의 제목으로 되는 문자렬을 설정한다. 이것을 빈 문자렬로 할수도 있지만 일반적으로 
창문에는 제목을 준다. 작성 할 창문의 형 태는 dwStyle 에 설정 한다. 

WS_OVERLAPPEDWINDOW 라는 마크로는 체 계 차림 표, 경 계 선, 최 소화단추，최 대 
화단추，닫기단추를 가진 표준적 인 창문을 지 정한다. 이 형 식의 창문이 가장 일 반적 이 지 
만 임의의 형태를 지정할수도 있다. 그렇게 하려면 요구하는 형식을 가리키는 마크로들 
을 OR 연산자로 결합하여 지정해 야 한다. 아래 에 몇 가지 창문형식들을 보여 주었다. 


WS—OVERLAPPED 

경계선을 가지는 중첩된 창문 

WS—MAXMIZEBOX 

최대화단추를 가지는 창문 

WS—MINIMIZEDBOX 

최소화단추를 가지는 창문 

WS.SYSMENU 

체 계 차림 표를 가지 는 창문 

WS HSCROOL 

수평홀림 띠 를 가지 는 창문 

WS—VSCROLL 

수직 홀림띠 를 가지 는 창문 


hThisInst 는 Windows 2000 에서는 무시된다. 그러 나 Windows 95/98 에서는 여기 
에 응용프로그람실체의 손잡이를 설정해야 한다. 따라서 여러가지 환경에서의 호환성을 
유지 하면서 또한 앞으로 생길수 있는 문제 점 을 방지 하기 위하여 륜곽코드에서처 럼 
hThisInst 에는 실체의 손잡이를 설정해야 한다. 이 책에서 작성하는 모든 프로그람들에 
서 이 수법을 리용한다. 

CreateWindowC ) 함수는 작성된 창문의 손잡이를 돌려 주며 창문을 작성할수 없으 
면 NULL 을 돌려 준다. 

창문이 작성되 였 다고 하여 곧 화면 에 표시 되 는것 은 아니 다. 창문을 표시하려 면 
ShowWindowi ) 라는 API 함수를 호출한다. 아래 에 선언을 보여 주었 다. 


BOOL ShowWindow ( HWND hwnd , int nHow ); 
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표시할 창문의 손잡이 를 hwnd 에 설정 한다. 표시 방법 을 nHow 에 설정한다. 창문 
이 처 음으로 표시 될 때 는 nHow 에 nWinMode(WinMain 에 주어 지 는 파라메터 ) 를 지 
정하여 야 한다. nWinMode 에는 프로그람기동시에 창문을 표시 하는 방법 이 주어 져 있 
다. 이 함수의 호출에 의 해 필요에 따라 창문을 표시 하거 나 삭제할수 있 다. nHow 에 지 
정할수 있는 주요값을 아래에 보여 주었다. 


가려키는 마크로 효 과 


SW.HIDE 

창문을 표시하지 않는다. 

SW-MINIMIZE 

창문을 최 소화하여 아이 콘으로 표시한다. 

SW MAXMIZE 

창문을 최대화한다. 

SW_RESTORE 

창문을 보통 크기 로 한다. 


ShowWindow( ) 함수는 창문의 마지막 표시상태를 돌려 준다. 이미 창문이 표시되 
여 있다면 령이 아닌 값을, 창문이 표시되여 있지 않으면 령을 돌려 준다. 

륜곽코드에서는 필요 없지만 실제로는 모든 Windows 2000 프로그람에서 필요한 처 
리 로 되기때 문에 UpcIateWInclowf J 함수돠 호출도 진행된다. 이 함수의 호출에 의 하여 
Windows 2000 은 기본창문의 갱신이 필요하다는것을 알리는 통보문을 응용프로그람에 
보내게 된다. (이 통보문에 대해서는 다음 장에서 설명한다.) 

를보문순환고리 

륜곽코드의 마지 막부분은 통보문순환고리이 다. 통보문순환고리 는 모든 Windows 
2000 응용프로그람에서 사용된다. 통보문순환고리의 역 할은 Windows 2000 에서 보내온 
통보문을 받아 들이 고 그것 을 처 리하는것 이 다. 응용프로그람의 실 행 중에 는 통보문의 전 
송이 계속된다. 이 통보문들은 읽어 들여 처리될 때까지 응용프로그람의 통보문대기렬에 
보관되 여 있다. 응용프로그람에 서는 통보문을 읽 어 들일 준비 가 될 때 마다 
GefAfeasageO 라는 API 함수를 호출한다. 아래 에 선언을 보여 주었 다. 

BOOL GetMessage(LPMSG msg, HWND hwnd, UNIT min, UNIT max )； 

받은 통보문은 msg 에 보관된다. 모든 통보문은 아래 에 보여 주는 MSG 구조제로 표 
시된 다. 

// MSG 구조체 
typedef struct tagMSG 
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UNIT message ； 
WPARAM wParam; 


HWND hwnd ； 


// 통보문을 보내는 창문 
// 통보문 


LPARAM IParam ； 


DWORD time ； 
POINT pt ； 


// 통보문에 대한 정보 
// 통보문에 대한 정보 
// 통보문을 보내는 시 간 
// 마우스의 x, y 위치 


}MSG ； 


MSG 구조체에서는 통보문을 보내는 창문의 손잡이가 hwnd 에 보관된다. 모든 
Windows 2000 통보문은 32 bit 의 옹근수로서 message 에 보관된 다. 매 개 통보문과 관련 
된 정 보는 wParam , IParam 에 보관된다. WPARAM 과 LPARAM 도 32 bit 이 다. 


이식과 관련한 요점 : MSG 구조체의 message 성원은 16 bit Windows 에서 16 bit 로 되여 
있 다. 이 성원은 Windows 2 M 0 에서는 32 bit 이 다. 이와 마찬가지로 16 bit Windows 에 
서는 16 bit 인 wParam 성원도 Windows 2000 에서는 32 bit 이다. 

통보문이 발송된 시간은 社 me 성원에 ms 단위로 보관된다. 

pt 성 원에 는 통보문이 발송될 때 의 마우스자리표가 보관된다. 자러표가 보관되 는 
POINT 구조爲는 아래와 같이 정의되여 있다. 

typedef struct tagPOINT { 

LONG x, y ； 

} POINT ； 

응용프로그람의 통보문대기렬에 통보문이 존재하지 않는 경우는 GetMessage ( ) 의 
호출에 의 해 Windows 2000에 조종이 넘 겨 진다. 

GetMessage ( ) 의 hwnd 파라메 터는 통보문을 받아 들이는 창문을 지정하기 위한것 
이다. 한개의 응용프로그람이 여러개의 창문으로 구성되는 경우도 있으므로 그가운데서 
특정한 창문에 보내는 통보문만을 받아 들이게 해 야 하는 경우도 있다. 응용프로그람에 
전송되 여 오는 모든 통보문을 받으려면 이 과라메 터 에 NULL 을 설정 한다. 

GetMessageC ) 의 나머지 두개의 파라메터는 받아 들이는 통보문의 범위를 지정 한것 
이다. 일반적으로는 응용프로그람에서 모든 통보문을 받아 들인다. 그러자면 륜곽코드에 
서처럼 min 과 max 를 0 으로 설정해 야 한다. 
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사용자가 프로그람을 완료하면 GetMessage ( ) 는 령을 돌려 주며 이것에 의하여 통 
보문순환고리가 끝난다. 그밖의 경우에는 령 아닌 값을 돌려 준다. 오유가 발생한 경우 
에는 -1 을 돌려 준다. 그러나 오유가 발생하는 일은 거의 없으므로 이 책의 프로그람들 
에서는 그에 대응하지 않고 있다. 

통보문순환고리내 에서는 두개의 함수가 호출된다. 첫 함수는 TranslateMessage () 과 
는 API 함수이다. 이 함수는 Windows 2000 에 의하여 생성된 가상건코드를 문자통보문 
으로 변환한다. (가상건코드에 대해서는 후에 설명한다.) 모든 응용프로그람에 필수적인 
것은 아니지만 프로그람을 건반으로도 조작할수 있게 하기 위해서 대부분의 경우에 
TranslateMessage ( ) 가 사용된다. 

통보문이 호출되 여 변환되 면 DispatchMessage ( ) 라는 API 함수를 사용하여 통보문 
을 Windows 2000 에 발송한다. Windows 2000은 프로그람의 창문함수에 넘 길 때까지 이 
통보문을 보관한다. 

통보문순환고리 가 끝나면 WinMain ( ) 함수는 Windows 2000 에 msg.wParam 의 값 
을 돌리 여 완료한다. 이 파라메터 에는 프로그람을 완료할 때의 완료코드가 보관된다. 

참문 함수 

륜곽코드에 들어 있는 두번째 함수는 장문함수이 다. 여 기 에서는 WindowFuncC ) 라 
는 함수이름으로 되 여 있지만 다른 이름으로 할수도 있다. 창문함수에는 Windows 2000 
으로부터 통보문이 넘 어 온다. MSG 구조체의 첫 4 개의 성분이 이 함수의 호출파라메터 
들로 된 다. 그러 나 륜곽코드에서 참조되 는 파라메터는 통보문을 가리 키 는 파라메 터 뿐이 다. 

륜곽코드의 창문함수는 WM_DESTROY 라는 통보문만을 처 리한다. 이 통보문은 사 
용자가 프로그람을 완료할 때 발송된 다. 이 통보문을 받은 때 는 PostQwtMessageC ) 라 
는 API 함수를 호출해 야 한다. 이 함수의 파라메터 에 주어 지 는 값은 WinMainC ) 내 의 
msg.wParam 에 표시되는 완료코드로 된다. PostQuitMessage ( ) 의 호출에 의하여 응용 
프로그람에는 WM_QUIT 통보문이 전송된다. 이에 의해 GetMessage ( ) 는 false 를 돌려 
주고 프로그람이 완료되게 된다. 

Mn 公 owPuncO 에 서 받는 그밖의 통보문들은 모두 DefWindowProc ( )를 호출하여 
Windows 2000 에 넘기여 암시적처리를 진행한다. 모든 통보문은 어떤 방법으로든 처리 
해 야 하므로 이 수법을 사용할 필요가 있다. 

매 통보문을 처 리한 다음 창문함수의 돌림값으로서 적당한 값을 돌려 주어 야 한다. 
대부분의 통보문은 령을 돌려 주면 좋게 되 여 있다. 그러나 다른 값을 돌려 주어 야 하는 
경우도 있다. 
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■ fclK ■폐 


창문의 위치 


많은 응용프로그람들에서는 프로그람기동시 창문의 위치와 크기의 설정을 

Windows 2000 에 맡기는것이 보편적이지만 이것을 자체로 설정할수도 있다. 이 
를 위하여서는 창문의 왼쪽 웃 모서리의 자리 표，창문의 너비, 높이를 
CreateWindow ( ) 에서 지정해야 한다. 실례로 륜곽코드에서 CreateWindow ( ) 
를 호출하는 부분을 아래의 프로그람코드로 변경하면 창문은 화면의 왼쪽웃부분 

에 너 비 300, 높이 100으로 표시된다. 


hwnd = CreateWindow ( 


szWinName, 

// 창문들라스이름 

“Window 2000 Skeleton”, 

// 제목 

WS_OVERLAPPEDWINDOW, 

// 창문의 형래 

0 , 

// X 자리 표 

0 , 

// y 자러 표 

300, 

// 너비 

100, 

公높이 

NULL, 

// 어미창문이 없음 

NULL, 

// 차림표 없음 

hThisInst, 

// 프로그람실체손잡이 

NULL 

)； 

// 보조파라메 터 함수 

창문의 위치나 크기를 지정하는 경우에는 이것이 장치단위로 표시된다는것을 

명심해야 한다. 장치단위란 장치에서 

사용되 는 물리 단위 (여 기 에서는 화소) 이 다. 

이것은 자리표와 크기가 화면에 대하여 설정된다는것을 의미한다. 화면의 왼쪽웃 
모서 리 의 자리 표가 0,0 으로 된다. 후에 설명하지 만 창문에 대 한 출력 은 론리단위 
로 표시된다. 론리단위는 창문에서 사용되는 현재의 넘기기방식에 따라 차이난 

다. 창문의 위치는 화면전체에 대하여 

지 정 하는것 이 므로 CreateWindow ( ) 에 서 

는 론리 단위 가 아니 라 물리 단위 가 사용된다. 


모들정의파일 


16 bit 의 Windows 에서는 모든 프로그람에서 모둘정의파일이 필요하다. 
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모둘정의파일은 16 bit 의 환경에서 필요되는 어떤 정보나 설정이 기록된 본문파일이 
다. 그러나 Windows 2000의 32 bit 방식에서는 거의나 사용되지 않는다. 모든 모둘정의 
파일에는 확장자로서 .DEF 가 사용된다. 실례로 우에서 본 륜곽코드의 모둘정의파일이 
라면 SKEL.DEF 라는 파일 이 름을 가지 게 된 다 . Windows 3.1 과의 아래 방향호환성 을 유 
지 하기 위한 모둘정 의 파일을 아래 에 표시 한다. 

DESCRIPTION ‘Skeleton Program ’ 

EXETYPE WINDOWS 

CODE PRELOAD MOVEABLE DISCARDABLE 
DATA PRELOAD MOVEABLE MULTIPLE 
HEAPSIZE 8192 
STACKSIZE 8192 
EXPORTS WindowFunc 


모둘정의 파일에는 프로그람의 이름이 나 설명 이 서술되 여 있다. ( DESCRIPTION ) 이 
것은 생 략할수 있다. 실행파일 이 DOS 용 등이 아니 라 Windows 용이 라는것도 표시되 여 
있다. ( EXETYPE ) CODE 명 령 문은 프로그람전체 를 기동시 에 적재 ( PRELOAD ) 한다는것 
과 코드를 기 억기상에서 이동할수 있다는것 ( MOVEABLE ), 필요에 따라 코드를 기억기에 
서 파괴 하거 나 재 적재 할수 있 다는것 ( DISCARDABLE ) 을 Windows 2000 에 알려 준다. 

또한 프로그람의 자료도 실행시에 적재되여 기억기상에서 이동할수 있다는것과 프로그 
탐의 개개의 실체가 여 러가지 자체의 자료를 가진다는것 ( MULTIPLE ) 을 표시하고 있다. 프 
로그람의 더미령역의 크기 ( HEAPSIZE ) 와 탄창령역의 크기 ( STACKSIZE ) 도 지정한다. 

마감으로 창문함수의 이 름을 수출한다. ( EXPORTS ) 수출에 의 해 Windows 3.1 이 
창문함수를 호출하게 된다. 

참고 : 모둘정의과일은 Windows 2( X )0 프로그람을 작성할 때는 거의 쓰이지 않는다. 


이름붙이기규약 


이 장을 마치면서 함수나 변수의 이름을 붙이는 방법을 설명하기로 한다. Windows 
프로그람을 작성 해 본 경험 이 없는 사람들은 륜곽코드에서 쓰인 변수나 과라메터의 이름 
들에서 의문을 가졌을것이다. 이러한 이름들은 Microsoft 가 고안한 Windows 프로그람 
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작성에서의 이름붙이기규약야 따른것이다. 함수의 경우에 동사，명사의 순서로 함수이름 
을 달아준다. 동사와 명사의 첫 문자는 대문자로 한다. 이 책의 많은 실례프로그람들에 
서는 이 이름붙이기규약을 리용하고 있다. 

변수의 경우에는 변수의 이름속에 자료형을 반영하는 정보를 삽입하는 약간 복잡한 
수법을 고안하였다. 이것은 변수이름의 앞에 소문자로 자료형을 나타내는 앞붙이를 붙여 
주는것 이 다. 자료형을 나타내는 앞붙이를 표 2-1 에 주었다. 

그러 나 자료형 의 앞붙이 를 사용하는 방법 에 는 여 러 가지 로 고려해 야 할 문제 가 있 다. 
대 다수의 Windows 프로그람작성 자들은 이 방법 을 채 용하고 있지 만 Windows 프로그 
람작성자가 아닌 사람들은 리용하지 않고 있다. 


표 2-1. 변수의 자료형을 표시하는 앞불이 


b ^ - 

론러 형 ( lbyte ) 

C 

문자 ( lbyte ) 

dw 

부호 없는 긴 옹근수 

f 

16 bit 의 비트마당(기발) 

fn 

함수 

h 

손잡이 

1 

긴 옹근수 

IP 

long 지시자 

n 

짧은 옹근수 

P 

지 시 자 

pt 

화면상의 자리표를 가리키는 긴 옹근수 

w 

부호 없는 짧은 옹근수 

sz 

령으로 끝나는 문자렬에 대한 지시자 

lpsz 

령 으로 끝나는 문자렬 에 대 한 long 지 시 자 

rgb 

RGB 색 값을 가리 키 는 긴 옹근수 
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제 3 장 


응용프로그람의 진수: 
통보문과 기본입출력 


제 2 장에 서 작성 한 륜곽코드는 Windows 2000 프로그람의 기 틀을 보여 
주지만 그자체가 수행하는 기능은 없다. 실용적 인 프로그람으로 되자면 두 
가지 기본적인 처리를 할수 있어야 한다. 

첫째로，여러가지 통보문에 응답하는것이다. 통보문에 대한 응답은 모 
든 Windows 2000 응용프로그람의 중심적인 처리로 된다. 둘째로，프로그 
람이 어 떤 의 미 를 가지 는 정 보를 사용자에 게 제 공하는것 이 다. (실례 로 화면 
에 정보를 출력하는것) 

다른 조작체계와는 달리 Windows 에서는 사용자에게 정보를 표시하 
여 제공하는것이 간단하지 않다. 사실 출력과 관련된 처리는 모든 
Windows 응용프로그람에서 많은 부분을 차지하게 된다. 통보문의 처리와 
정보표시기능이 없이는 실용적인 Windows 프로그람을 작성할수 없다. 

그러므로 이 장에서는 통보문에 대 한 응답과 기본입출력에 중점을 두 
고 학습한다. 먼저 문자렬을 표시하는 간단한 방법을 시험해 보자. 
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들보 칸 


화면에 정보를 출력하는 가장 간단한 방법은 통보칸을 사용하는것 이다. 통보칸은 사 
용자에 게 통^% 표시하거 나 응답을 기 다리 게 하기 위한 창문이 다. 프로그람작성 자자신 
이 작성해야 하는 다른 류형의 창문들과는 달리 통보칸은 조작체계에서 제공해 준다. 일 
반적으로 통보칸의 역할은 어떤 사건의 발생을 사용자에게 알려 주는것 이 다. 그러 나 통 
보내 용에 응답하는 어떠 한 선택의 여지를 사용자에게 주기 위한 목적 에도 통보칸을 사용 
할수 있다. 실례로 [ OK ] 나 [ CANCEL ] 등을 사용자가 선택하게 하는데 통보칸을 사용 
한다. 


참고 : 통보칸이라는 용어에서 통보라는것은 프로그람의 창문 함수에 전송되는 Windows 
2000 의 통보문이 아니라 화면에 표시되는 문자렬을 의미한다. 기술적으로 중복되는 점 
도 있지만 통보칸과 통보문은 전혀 다른 내용이다. 


MessageBox ( M 는 API 함수를 사용하여 통보칸을 작성 한다. 아래 에 이 함수의 선 
언을 보여 주었다. 


int MessageBox (HWND hwnd , LPCSTR lpText , LPCSTR lpCap 仕 on 
UINT MBType ) : 

hwnd 는 어 미 창문의 손잡이 이 다. lpText 는 통보칸의 내 부에 표시 하려 는 문자렬 에 
대 한 지 시 자이다. lpCap 仕 on 이 지 적 하는 문자렬은 통보칸의 제 목이 다. MBType 값은 통 
보칸안에 표시 하는 단추나 아이콘의 종류 등 통보칸의 형식을 지정한다. 주요한 설정값 
을 표 3-1 에 주었다. 이 마크로들은 WINDOWS.H 에 정의되여 있다. 상반된 의미를 가 
지 지 않는 마크로들은 OR 연산자로 결 합하여 지 정할수 있 다. 


표 3-1. MBType 의 주요설정값 


MB—ABORTERETRYIGNORE 

：_ fStop ] , [ Retry ] , [ Ignore ] 단추를 표시 한다. 

MB_CANCELTRYCONTINUE 

[ Cancel ] , [ Retry ] , [ Continue ] (Windows 
2000 에 추가된것 )를 표시 한다. 

MBJCONEXCLAMATION 

감탄부호아이 콘을 표시 한다. 
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MBJCONERROR 

정 지 아이 콘을 표시 한다. 

MBJCONINFORMATION 

정 보아이 콘을 표시한다. 

MBJCONQUESTION 

의문표아이콘을 표시한다. 

MBJCONSTOP 

MBJCONERROR 와 같다. 

MB OK 

[ | OK ] 단추를 표시 한다. 

MB OKCANCEL 

[◦戒와 [ Cancel ] 단추를 표시한다. 

MB RETRYCANCEL 

[ Retry ] , [ Cancel ] 단추를 표시 한다. 

MB—YESNO 

[ Yes ] , [ No ] 단추를 표시 한다. 

MB_YESNOCANCEL 

[ Yes ] , [ No ] , [ Cancel ] 단추를 표시 한다. 


MessageBoxC ) 는 통보칸에 대한 사용자의 응답을 돌려 준다. 돌림값은 아래와 같다. 


[ Stop ] 

IDABORT 

[ Retry ] 

IDRETRY 

[ Ignore ] 

IDIGNORE 

[ Cancel ] 

IDCANCEL 

[ Continue ] 

IDCONTINUE (Windows 2000 에 추가된것 ) 

[ No |: 

IDNO 

[ Yes ] 

IDYES 

[ OK ] 

IDOK 

[ Retry ] 

IDTRYAGAIN (Windows 2000 에 추가된 것 ) 


MBType 의 값에 따라 표시되는것은 단추나 아이콘만이 라는데 주의해 야 한다. 일반 
적 으로 통보칸은 사용자에게 통보문과 [ OK ] 단추를 제공하는데 많이 쓰인다. 이 러 한 경 
우에 는 프로그람에 서 돌림값을 무시한다. MessageBoxC ) 함수를 호출하면 Windows 
2000 은 통보칸을 표시해 준다. MessageBoxC ) 는 자동적으로 창문을 작성하고 그 내부 
에 통보내용을 표시한다. 그밖에는 아무런 처리도 진행하지 않는다. 실례로 아래와 같이 
MessageBoxC )를 호출하면 다음의 통보칸이 표시된다. 

i = MessageBoxChwnd , “This is Caption ”, “ This is Title ", MB_OKCANCEL )； 

사용자가 누른 단추의 종류에 따라 i 값은 IDOK , IDCANCEL 와 어 느 하나로 된 다. 
통보칸은 례를 들면 오유발생과 같이 어떤 사건이 발생 하였다는것을 사용자에게 알려 주 
는데 많이 쓰인다. 통보칸의 사용방법은 간단하므로 화면에 어떤 오유수정정보를 표시하 
는데 도 편리한 방법 으로 쓰인다. 이 책의 많은 실례프로그람들에서 화면에 정 보를 표시 
하기 위한 편리한 수단으로서 통보칸을 사용한다. 
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Windows 2000 의 새로운 기 능 : MessageBox ( ) 의 형 태 를 표 시 하 는 마크 로 
MB_CANCELTRYCONTINUE 와 돌 림 값 의 IDTRYAGAIN , IDCONTINUE 는 
Windows 2000 에 새롭게 추가된것이다. 번역프로그람의 종류에 따라서 이러한 추가선택 
을 사용하기 위해서 WINVER 마크로를 0 x 500 으로 정의할 필요가 있다. 


Windows 2000 으 I 통보문 


Windows 2000 에서 통보문은 유일한 32 bit 의 옹근수값으로 되 여 있다. Windows 
2000 은 통보문을 전송하여 프로그람과 련계를 취한다. 매개 통보문들은 어떤 사건에 대 
응되 여 있다. 실례 로 사용자가 건반을 눌렀다는것 을 표시하는 통보문, 마우스가 이동하 
였 다는것 을 표시 하는 통보문, 창문의 크기 가 변경 되 였 다는것 을 표시하는 통보문이 있다. 
매 개 통보문은 수값으로 식 별 할수 있지 만 일 반적 으로는 Windows 2( X )0 의 모든 통보문을 
정의한 마크로를 사용한다. 즉 통보문을 식별할 때 실제의 수값이 아니라 마크로의 이름 
을 사용한다. 프로그람에 WINDOWS . H 를 포함시키 면 일 반적 인 통보문들의 마크로가 
정의된다. 아래에 Windows 2000의 일반적인 통보문마크로를 몇개 보여 주었다. 

WM—CHAR WM—PAINT WM—MOVE 

WM_CLOSE WM_LBUTTONUP WM_LBUTTONDOWN 

WM—COMMAND WM_HSCROLL WM—SIZE 


통보문과 관련된 두개 의 값이 통보문과 함께 전달된 다. 첫번째 값의 자료형 은 
的兄 4 M 이며 다른 값의 자료형은 五 PA 私 W 이 다. Windows 2000 에서 이 자료형들은 
모두 32 bit 옹근수값을 나타낸다. 이 값들은 일반적 으로 wParam , IParam 이 라고 한다. 
wParam , IParam 악 내용은 통보문의 종류에 따라 다르다. 실례로 마우스의 자리표나 눌 
리운 건의 값 등이 보관되여 있다. 통보문을 처리할 때 wParam , IParam 의 내용을 참 
고한다. 
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이식과 관련한 요점 : 16 bit Windows 에서는 wParam 이 16 bit 값으로 되여 있 다. 
Windows 2000 에서는 wParam 이 32 bit 의 값이다. 16 bit 환경과 32 bit 환경에서는 통보 문 
의 의미가 달라 지는 경우가 있다. 이러한 차이가 16 bit 프로그람을 Windows 2000 ^ 이 
식할 때 문제점으로 되는 경우가 있다. 


제 2 장에서 설명한바와 같이 프로그람에서 실제로 통보문을 처리하는것은 창문함수 
이 다. 이 함수에 는 통보문을 보내는 창문의 손잡이，통보문자체， wParam , IParam 의 4 
개 의 파라메 터 가 주어 져 있다. wParam , IParam 의 내 용이 두개 단어의 값으로 분할되 
여 있는 경우도 있다. 그러므로 Windows 에는 LOWORD , HIWORD 라는 두개의 마크 
로가 정의되 여 있다. 이 마크로들은 각각 긴 옹근수값의 아래단어와 웃단어를 돌려 준다. 
아래 에 리용실례를 보여 주었다. 

x = LOWORD ( IParam ) : 

x = HIWORD ( IParam ) : 

후에 이 마크로들을 실지 사용하게 된다. 

Windows 2000 에는 수많은 통보문마크로들이 정의되여 있다. 모든 통보문들을 다 
설 명할수 없 으므로 이 장에 서 는 중요한것 들만 몇 가지 설 명 한다. 기 타 마크로들은 필 요한 
경우에 다음 장들에서 설명 한다. 


건입력에 대한 응답 


Windows 2000 에서 중요한 통보문의 하나는 건반이 눌러워 졌을 때 발생하는 통보 
문이 다. 이 통보문을 1次라고 한다. 응용프로그람은 건반으로부터 직접 건입력 
을 받지 못한다. 건반이 눌리워 졌을 때는 능동상태에 있는 창문(현재 입력초점을 가지 
고 있는 창문)에 통보문이 전송된다. 이 구조를 실제로 확인해 보기 위해 제 2 장에서 작 
성한 륜곽코드를 확장하여 건 입 력 통보문을 처 리 해 보자. 

WM_CHAR 가 전송되 였을 때 는 눌러 운 건에 해 당한 ASCII 코드가 wParam 에 보관 
되여 있 다. LOWORD ( IParam ) 에는 건이 눌러워 진 상태에 있을 때의 건반복희 수가 보 
관되여 있 다. HIWORD ( IParam ) 의 매 비트는 표 3-2 에 표시 한 의미를 가진 다. 
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표 3-2. HIWORD ( lParam ) 이 가러키는 건반정보 


15 

건이 놓여져 있으면 on , 눌러워 져 있으면 o 打 

14 

통보문을 전송하기전에 건이 눌러워 져 있으면 on , 눌러워 져 있 
지 않으면 off 

13 

[ Alt ] 건이 동시에 눌러워 진 때 on , 눌러워 져 있지 않으면 off 

12 

예약 

11 

예약 

10 

예약 

9 

예약 

8 

확장건반의 특수건이 눌러워 져 있으면 on , 그렇지 않으면 off 

7-0 

제작자에 의존하는 건코드(주사코드) 


이제 작성하게 될 프로그람에서는 눌러워 진 건값을 보관하고 있는 wParam 만을 리 
용한다. 그러나 Windows 2000 은 건입력에 관한 체계의 상세정보를 제공해 준다는것을 
기 억해 두어 야 한다. 물론 이 정보를 리용하는가 무시하는가는 구체적 인 상황에 따라 결 
정된 다. 

WM_CHAR 통보문을 처 리 하자면 프로그람의 창문함수의 switch 문에 코드를 추가해 
야 한다. 실례 3-1 에 2썸/최내용을 통보칸에 표시하는 프로그람을 보여 주었다. 

실 례 3-1. WM CHAR 프로그람 
// WM_CHAR 통보문의 처 리 

#include 〈 windows. h> 

♦include <cstring> 
ttinclude <cstdio> 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM); 
char szWinName[] = "MyWin" : // 창문믈라스의 이름 
char str[255] = ""； // 출력할 문자렬을 보관한다 . 

int WINAPI WinMain (HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 
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{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

// 창문물라스를 정의 한다 . 

wcl. cbSize = sizeof (WNDCLASSEX) ; 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 암시적형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 

wcl.IpszMenuName = NULL ； // 를라스차림표는 없다 . 
wcl.cbClsExtra = 0 ； // 보조기억기령역은 필요 없다 . 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 


// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


A 창문물라스가 등록되 였다면 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow( 
szWinName, // 창문믈라스의 이름 
"Processing WM_CHAR Messages", // 제목 
WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자리 표를 Windows 가 결 정 하게 한다 . 
CW_USEDEFAULT, // Y 자러 표를 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 창문의 너 비를 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 창문의 높이를 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 
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NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

)； 


// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while(GetMessage(&msg , NULL, 0, 0)) 

{ 

TranslateMessage(&msg); // 건반통보를 변환한다 . 
DispatchMessage(&msg) ; // Windows 2000 에 조종을 넘 긴다 . 

} 

return msg.wParam; 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬로부터 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

switch (message) { 

case WM_CHAR ： // 건 입 력 을 처 리 한다 . 
sprintf(str, "Character is %c", (char) wParam) : 
MessageBoxChwnd, str, "WM_CHAR Received", MB_OK); 
break ； 

case WM_DESTROY ： // 프로그람을 완료한다 . 

PostQuitMessage (0) : 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2(X)0 에 처 리를 맡긴다 . */ 

return DefWindowProc(hwnd, message, wParam, IParam) : 

} 
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return 0; 

} 

이 프로그람의 실행결과를 그림 3-1 에 보여 주었다. 



그림 3-1. WM_CHAR 프로그람의 실행결과 


WindowFunc( ) 프로그람코드중에서 다음의 부분에 주목하시오. 

case WM.CHAR ： // 건입 력을 처 려 한다 . 

sprintf (str, “Character is %c”, (char) wParam); 

MessageBoxChwnd, str, “WM_CHAR RECEIVED”, MB_OK) ； 
break ； 

case 문에 WM_CHAR 통보문의 처 리가 추가되였다는것을 알수 있다. 프로그람을 실 
행 하면 건이 눌러울 때마다 WM_CHAR 통보문이 발생되여 WindowFuncO 에 전송된다. 
WM_CHAR 를 처 리 하는 case 문에서는 wParam 에 보관된 문자를 sprintf () 를 사용하여 
문자렬로 변환하고 그것을 통보칸에 표시한다. 

건반통보의 상세 


竹孔는 가장 일반적으로 처리되는 통보문이지만 그밖에도 여러가지 건반 s 보 
들이 있 다. 사실 WM_CHAR 는 프로그람의 통보문순환고리 의 TranslateMessage ( M 
의하여 생성되는 통합적 인 통보문으로 되 고 있다. 

보다 낮은 준위 에 서 보면 건 이 눌러 울 때 마다 Windows 2(X)0 은 두개 의 통보문을 생 
성 시킨다. 건이 눌러 우면 抑고쇼公五' KDOP 犯V통보문이 발송되 고 건을 놓으면 WM—KEYUP 
통보문이 발송된다. 가능한 경우에는 WM_KEYDOWN 과 WM_KEYUP 통보문의 조합이 
TranslateMessage( ) 에 의하여 WM_CHAR 통보문으로 변환된다. 

그러므로 만일 통보문순환고리에 TranslateMessage( ) 가 포함되여 있지 않으면 프 
로그람은 WM_CHAR 통보문을 접수할수 없다. 이것을 확인하기 위하여 앞의 프로그람 
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에서 TranslateMessage ( )를 호출하는 부분을 설명문으로 만들어 놓으시오. 이렇게 하 
면 프로그람은 건입력에 응답하지 못하게 된다. 

WM _ KEYDOWN , WM_KEYUP 이 문자입 력 에 거의 나 사용되지 않는 리 유는 이 통 
보문들이 제 공하는 정 보가 가공되지 않은 자료이 기때 문이 다. 실례 로 wParam 에 는 
ASCII 코드가 아니 라 가상건코드가 들어 있다. TranslateMessage ( ) 의 기능의 하나로서 
shift 건상태를 고려하여 가상건코드를 ASCII 코드로 변환하는 기능이 있다. 
TranslateMessage ( ) 에는 건의 자동반복을 자동적으로 처리하는 기능도 있다. 가상건코 
三란 장치 에 의 존하지 않는 건코드이 다. 모든 를퓨터 의 건반에 는 ASCII 문자모임 에 대 응 
되여 있지 않는 건이 여러개 있다. 방향건이나 기능건 등이 그 실례이다. 

모든 건에 대응되여 있는것은 가상건코드이다. 모든 가상건코드의 값은 
WmUSER . H (프로그람에 WINDOWS.H 를 인용하면 자동적으로 인용된다.)에 마크로 
로서 정의되여 있다. 이 마크로들은 1_로 시작하는 이름을 가진다. 아래에 가상건코 
드들의 실례를 준다. 


가상건 코- 


VK—DOWN 

아래 방향건 

VK LEFT 

왼쪽 방향건 

VK—RIGHT 

오른쪽방향건 

VK UP 

웃방향건 

VK—SHIFT 

Shift 건 

VK CONTROL 

Ctrl 건 

VK—ESCAPE 

Esc 건 

VK F 1 〜 VK F 24 

기능건 

VK—HOME 

Home 건 

VK—END 

End 건 

VKJNSERT 

Insert 건 

VK DELETE 

Delete 건 

VK PRIOR 

Page Up 건 

VK NEXT 

Page Down 건 

VK A 〜 VK Z 

영문자건 

VK _0 〜 VK _9 

수자건 


소 SC // 코드에 대응되는 건에 대해서는 TranslateMessage ( ) 가 가상건코드를 ASCII 
코드로 변환하고 이것을 WM_CHAR 통보문과 함께 보낸다. 물론 ASCT 코드에 대응되지 
않는 건은 변환할수 없다. 따라서 프로그람에서 ASCII 코드에 대응되지 않는 건입력을 처 
리 하려 고 한다면 WM_KEYDOWN 또는 WM _ KEYUP (또는 둘 다)를 사용해 야 한다. 

앞의 프로그람을 확장하여 WM_KEYDOWN 과 WM_CHAR 의 두 통보문을 처 리 할 
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수 있게 해 보자. (실례 3-2) WM_KEYDOWN 처리에서는 건이 방향건, Shift 건, Ctrl 
건중의 어느 건 인가를 나타낸다. 프로그람의 실행결과는 그림 3-2 에서 보여 주었다. 


실례 3-2. WM KEYDOWN 프로그람 


// WM_KEYDOWN 과 WM_CHAR 통보문의 처 리 


itinclude 〈 windows. h> 
ttinclude <cstring> 
^include <cstdio> 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
char szWinName[] = ” My Win"; // 창문들라스의 이름 
char str[255] = ””; // 출력할 문자렬을 보관한다 . 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl; 

// 창문믈라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ； 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName; // 창문들라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0 ； // 체계설정의 형식 


wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ； // 큰 아이콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC.ARROW) ； // 유표의 형 식 

wcl.IpszMenuName = NULL ； // 콜라스차림표는 없다 . 
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wcl.cbClsExtra = 0 ； // 보조기억기령역은 필요 없다 . 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 

// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


A 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow( 
szWinName, // 창문믈라스의 이름 

"Processing WM_CHAR and WM_KEYDOWN Messages", 
WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Window 가 결 정 하게 한다 . 
CW_USEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 창문의 너 비는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, //창문의 높이 는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메터는 없 다 . 

)； 


// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) ; 
UpdateWindow (hwnd ); 


II 통보문순환고리를 작성 한다 . 

while(GetMessage(&msg , NULL, 0, 0)) 

{ 

TranslateMessage(&msg); // 건반통보를 변환한다 . 
DispatchMessage(&msg) : // Windows 2000 에 조종을 넘 긴다 . 

} 

return msg.wParam; 


} 
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A 이 함수는 Windows 2000 에서 호출되 여 통보문대기렬에서 
꺼낸 통보문을 받아 들인다. 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

switch (message) { 
case WM.CHAR： // 문자를 처 려 한다. 
sprintf (str, "Character is %c”, (char) wParam); 

MessageBox(hwnd, str, "WM_CHAR Received", MB_OK) ； 
break； 

case WM.KEYDOWN： // 가상건코드률 처 리 한다. 
switch ((char) wParam) { 

case VK_UP: 

strcpy(str, ” Up Arrow”); 
break； 

case VK—DOWN: 
strcpy (str, ” Down Arrow ’’) ； 
break； 

case VK—LEFT: 
strcpy (str, ’’Left Arrow"); 
break； 

case VK—RIGHT: 
strcpy (str, "Right Arrow") ； 
break； 

case VK.SHIFT： 
strcpy (str, "Shift”) ； 
break； 


case VK_CONTROL: 
strcpy (str, "Control"); 
break； 
default： 

strcpy (str, "Other Key") ； 

} 

MessageBox(hwnd, str, "WM_KEYDOWN Received，，, MB_OK) ； 
break； 

case WM_DESTROY： // 프로그람을 완료한다. 
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PostQuitMessage (0) ; 
break； 
default： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다. */ 

return DefWindowProc(hwnd, message, wParam, IParam); 


return 0； 



그림 3-2. WM_KEYDOWN 프로그람의 실행결과 


여기서 한가지 중요한 내용을 기억해 두어야 한다. 실례로 [幻와 같이 표준적인 
ASCII 코드에 해 당한 건을 누른 경우에 프로그람은 두개의 통보문 즉 WM_CHAR 과 
WM_KEYDOWN 통보문을 받게 된다. 

그것은 건을 누를 때마다 WM_KEYDOWN 통보문이 생성되며 (모든 건입력은 
WM_KEYDOWN 통보문을 발생 한다.) 만일 ASCII 코드에 대 응하는 건인 경 우에 는 
TranslateMessage ( ) 에 의 하여 WM_CHAR 통보문이 생성되기 때문이다. 

기타 건반통보 

WM_KEYDOWN 이 나 WM_KEYUP 이 외 에 도 아래 에 표시 한 여 러 개 의 건반통보 A 있 다. 


WM.SYSKEYDOWN 

체계건이 눌러워 졌을 때의 가공되지 않은 건반통 
보. wParam 에 는 가상건코드가 넣 어 진 다. 

WM_SYSKEYUP 

체계건을 놓은 때의 가공되지 않은 건반통보. 
wParam 에 는 가상건코드가 넣 어 진다. 

WM—DEADCHAR 

현재의 환경에서 건변환이 진행되지 않는 경우에 
TranslateMessage ( ) 에 의 해 생 성 되 는 통보문. 
wParam 에 는 문자코드가 넣 어 진 다. 
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WM—SYSCHAR 

체계건이 눌리워 졌을 때 TranslateMessage( ) 에 
의하여 생성되는 통보문. wParam 에 문자코드가 넣 
어 진다. 

WM—SYSDEADCHAR 

현재 환경에서 체계건의 변환이 진행되지 않은 경 
우에 TranslateMessage( ) 에 의하여 생성되는 통보 
문. wParam 에 문자코드가 넣 어 진 다. 


체계건관련통보문은 [Alt] 건과 다른 건이 동시 에 눌리워 진 때 (실례로 [Alt] + [F]) 
생성된다. 모든 건반통보에 있어서 IParam 의 값은 WM_CHAR 통보문의 IParam 과 내용 
이 갈다. 

대 다수의 프로그람들에 서 는 통보문순환고리 에 TranslateMessage( ) 를 포함시 켜 
WM_CHAR 통보문을 처 리할수 있게 한다. 그외 의 건반통보들은 특수한 용도의 경 우에 
만 사용된다. 다른 프로그람작성환경들에서는 저준위의 건반입력처리가 중요한 문제로 
취급되 였다. 그러 나 Windows 에서는 전혀 그렇지 않다. 왜 냐하면 Windows 에서는 편집 
칸이나 목록조종체 등 건입력을 자동적으로 처리하는 조종체가 제공되여 있기때문이다. 


참문에 문자렬들 표시하기 


통보칸은 정보를 표시하기 위한 가장 간단한 수단이지만 프로그람작성 자들의 모든 
요구를 다 만족시키지는 못한다. 통보칸을 사용하는것보다 약간 복잡하기는 해도 정보를 
표시하기 위한 다른 수단이 있다. 그것은 창문의뢰자구역에 직접 쓰는것 이 다. windows 
2000 은 문자렬파 도형의 두가지 출력을 지원한다. 여기에서는 문자렬을 출력하기 위한 
기본적인 방법을 설명한다. 도형출력과 관련해서는 다음 장에서 설명한다. 

창문에 문자렬 을 출력하는데 는 C 八:++의 표준입출력기능을 사용하지 않는다. 그 리 유 
는 간단하다. (VC++ 의 표준입출력함수나 연산자는 표준출력장치에 대하여 출력을 진행 
한다. 이와 반면에 Windows 프로그람에서는 창문에 대하여 출력을 진행한다. 어떻게 
문자렬 이 창문에 출력되는가를 보기 위해 건입 력된 문자를 통보칸이 아니 라 프로그람의 
창문에 표시 하는 실례 프로그람을 보자. 이 기능을 실현하는 WindowFuncC ) 를 아래 에 
보여 주었다. 


LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 
static unsigned j=0 ； 
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switch (message) { 

case WM.CHAR ： //건입 력을 처 리 한다 . 

hdc = GetDC(hwnd) : //장치 상황을 엄 는다 . 

sprintf (str, “% c”, (char)wParam) ; //문자를 문자렬 로 한다 . 

TextOut(hdc, j*10, 0, str, strlen(str)) ； // 문자를 출력 한다 . 
j++; 

ReleaseDC(hwnd, hdc) ； // 장치 상황을 해제 한다 . 
break ； 

case WM.DESTROY ： // 프로그람을 완료한다 . 

PostQuitMessage (0) ; 
break ； 

default ： 

// 이 switch 문에 지정된것 이외의 통보문은 
// Windows 2000 에 서 처 리된다 . 

return DefWindowProc (hwnd, message, wParam, IParam); 

} 

retrum 0 ； 

} 

case 문의 WM.CHAR 통보문처리부분을 보자. 여기서는 프로그람의 창문에 입력된 
문자를 그대로 출력한다. C / C ++ 의 표준입출력함수나 연산자를 사용하는 경우에 비하면 
이 코드는 간결하지 못하고 복잡한것으로 보일수도 있다. 그 리유는 Windows 에서는 
프로그람과 화면을 결합시킨 구조가 필요되기때문이 다. 

이 구조를 장乂/호별 《Device Context ) 이라고 부르며 GetDC () 를 호출하여 얻을수 있 
다. 현 단계에서는 장치상황에 대한 정확한 정의를 알 펼요는 없다. 이에 대해서는 다음 
절에서 설명한다. 장치상황을 엄으면 창문에 출력 이 진행되도록 되 여 있다. 처 리마감에 
장치상황이 ReleaseDC () 에 의하여 해제된다. 사용이 끝난 장치상황은 프로그람에서 반 
드시 해제해야 한다. 장치상황의 수는 기억기의 빈용량에 의하여 제한되며 그 수는 어디 
까지나 유한개이다. 만일 프로그람에서 장치상황을 해제시키지 않으면 결과적으로 장치 
상황을 사용할수 없게 되며 다음번 GetDC ( ) 호출이 실패한다. 장치상황해제가 실패한 
경우에 는 기억기잃기 (Memory leak ) 가 발생 한다. 

GtetfKV 와 ife / aaseZKV 는 API 함수들이 다. 아래 에 이 함수들의 선언을 보여 주었 다. 


HDC GetDC(HWND hwnd ) ; 


int ReleaseDC (HWND hwnd , HDC hdc ) : 


GetDC ( ) 는 hwnd 로 지정된 창문과 관련되는 장치상황을 돌려 준다. HDC 형은 장 
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치상황의 손잡이를 가리킨다. 장치상황을 얻을수 없는 경우에 함수의 돌림값은 NULL 
로 된다. 

ReleaseDCC ) 는 장치상황이 해제되면 TRUE , 그렇지 않으면 FAL 況: 를 돌려 준다. 
hwnd 는 장치상황을 해제하는 창문의 손잡이이다. hdc 는 GetDC () 를 호출하여 얻은 장 
치 상황의 손잡이 이다. 


이식과 관련한 요점 : 16 bit Windows 에서는 동시에 사용할수 있는 장치상황의 수를 다 
섯개로 제한하였다. Windows 2000 에서는 그 수가 빈 기억기용량에 의하여 결정된다. 


실제 로 문자를 출력 하는것은 : Tex 的 u 江 그라는 API 함수이다. 아래 에 선언을 보여 주 
었 다. 

BOOL TextOut (HDC hdc , int x , int y , LPCSTR lpstr , int nlength ) : 

TextOutC ) 함수는 lpstr 로 지정된 문자렬을 창문의 x , y 로 지정된 좌표에 출력한 
다.(암시적으로 자러표단위는 화소이다.) 문자렬의 길이를 nlength 에서 지정한다. 
TextOut ( ) 함수는 처리가 성공하면 령이 아닌 값을 돌려 주며 실패하면 령을 돌려 준다. 

WindowFunc ( ) 에서는 WM_CHAR 통보문을 받을 때마다 사용자가 입력한 문자를 
sprintf () 를 사용하여 한 문자길 이의 문자렬로 변환하고 TextOut ( ) 를 사용하여 창문에 
출력 한다. 

첫 문자는 (0, 0) 위치에 표시된다. 창문에서 의뢰자구역의 웃왼쪽모서리가 원점으로 
된다. 창문자러표는 화면이 아니라 항상 창문에 대하여 설정된다. 따라서 물리적으로 화 
면상의 그 어디에 창문이 있어도 첫 문자는 창문의 웃왼쪽모서리에 표시된다. 변수 j 는 
현재 입력된 문자를 앞문자의 오른쪽에 표시하기 위한 변수이다. 여기서는 두번째 문자 
는 (10, 0) 위치，세번째 문자는 (20, 0) 위치 등의 순서로 표시된다. 

Windows 에서는 자동적으로 위치를 갱신하는 유표라는 개념이 지원되지 않는다. 
따라서 TextOut ( )를 사용할 때마다 문자를 표시하는 적 당한 위 치를 지정해 야 한다. 
TextOut ( ) 에서는 행바꾸기 문자가 주어 져 도 행 바꾸기를 할수 없다. 이것은 타브에 대 
해서도 마찬가지이다. 이러한 처리는 작성자자신이 하여야 한다. 

설명을 계속하기에 앞서 프로그람코드에서 변수 j 를 증가하는 행을 설명문으로 바꾸 
어놓고 실험을 해 보자. 이렇게 되면 모든 문자가 (0， 0) 위치에 표시된다. Windows 는 
도형 에 기초한 체계이므로 매개 문자의 크기가 다르고 같은 위치에 문자를 덧써도 그전 
의 문자는 지워 지 지 않는다. 례 하면 W 다음에 i 라는 문자를 입 력 하면 W 의 일부가 표 
시된 상태로 남아 있다. 문자너비가 같지 않으므로 앞의 실례프로그람에서는 입력한 문 
자들사이 간격 이 균일하지 않다는것을 볼수 있다. 

이 실례프로그람에서 창문에 문자렬을 출력하는데 사용한 수법은 아무런 연구가 없 
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이 사용한 수법 이 다. 실제의 Windows 2000 응용프로그람에서는 이러 한 수법을 사용하지 
않는다. 

Windows 2000 의 모든 API 함수에 서 는 창문경 계 선을 벗 어 나는 출력 은 할수 없게 되 
여 있다. 출력은 자동적으로 자르기되여 경계선을 벗어나지 못하게 된다. 창문의 오른쪽 
끝에 이르면 그 이후의 문자는 표시되지 않는다는것을 알수 있다. 

하나의 문자를 출력하는 프로그람에 TextOutC ) 를 사용하는것 이 이상하게 생각될수 
도 있지만 Windows 2000 에는 한개 문자를 출력하기 위한 함수가 따로 없다. 그대신에 
Windows 2000 은 대화칸，차림표, 도구띠 등을 사용하여 사용자와 대화하는 수법을 제 
공한다. 의 뢰 자구역 에 문자렬 을 출력하기 위 한 함수는 몇 개 밖에 없 다. 출력 할 문자렬 의 
내용을 잘 준비한 다음 그것을 화면상의 어떤 위치에 표시하려면 TextOutC )를 사용하 
여야 한다. 

창문에 건입력내용을 표시하는 완성된 프로그람을 실례 3-3 에 주었다. 그림 3-3 은 
프로그람의 실행결과이다. 


실례 3-3. TextOut 프로그람 

// TextOut( )를 사용한 문자렬의 표시 


ttinclude 〈 windows. h> 

^include <cstring> 
itinclude <cstdio> 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM); 
char szWinNameG = n MyWin”; // 창문클라스의 이름 
char str[255] = // 출력할 문자렬을 보관한다 . 

int WINAPI WinMain (HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

// 창문들라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ； 
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wcl.Mnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문클라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ; // 큰 아이 콘 
wcl. hlconSm = NULL ； // 큰 아이론의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl.IpszMenuName = NULL ； // 믈라스차림표는 없음 
wcl.cbClsExtra = 0; // 보조기억기령역은 필요 없음 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) : 

// 창문콜라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문클라스가 등록되었으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 

"Display WM_CHAR Messages Using TextOut", // 형식 
WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CW_USEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 창문의 너 비는 Windows 가 결정하게 한다 . 
CW_USEDEFAULT, //창문의 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

)； 


// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode); 
UpdateWindow (hwnd); 
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// 통보문순환고리를 작성 한다 . 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

TranslateMessage(&msg) ； // 건반통보를 변환한다 . 
DispatchMessage(&msg) : // Windows 2000 에 조종을 넘 긴다 . 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬로부터 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 
static unsigned j=0 ； 

switch (message) { 

case WM.CHAR ： // 건입 력을 처 러 한다 . 
hdc = GetDC(hwnd) ； // 장치 상황을 얻 는다 . 
sprintf(str, "%c”, (char) wParam) ； // 문자를 문자렬로 한다 . 
TextOut(hdc, j*10, 0, str, strlen(str)) ； // 문자를 출력 한다 . 
j++; // 이 행을 설명문으로 해보시오 
ReleaseDC (hwnd, hdc) ； // 장치 상황을 얻 는다 . 
break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리 률 맡긴 다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam); 

} 


return 0 ； 
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그림 3-3. TextOut 프로그람의 실행결과 


장 치 상 황 


앞의 프로그람이 보여 주는바와 같이 창문에 출력하려면 먼저 장치상황을 얻어야 한 
다. 또한 창문함수를 벗 어 나기전에 장치상황을 해제 하여 야 한다. 

여기서는 장치상황이한 무엇인가를 설명한다. 장치상황이란 창문의 출력환경을 표시 
하는 구조체로서 장치구동기나 현재 서체의 종류 등 다양한 파라메터들을 보관한다. 뒤 
에서 설명 하지만 창문의 출력환경 을 조종하는것은 매우 편리한것 이 다. 

응용프로그람에서 창문의 의뢰자구역에 정보를 출력하기전에 장치상황을 얻지 않으 
면 출력 대 상으로 되 는 창문과 프로그람을 련관시 킬수 없 다. TextOut ( ) 나 다른 출력함 
수는 장치상황의 손잡이를 필요로 하므로 이 규칙은 자동적으로 강요되게 된다. 


WM_PAINT 틍보문의 처리 


응용프로그람이 받는 통보문들중에서 가장 중요한것의 하나는 竹乳이 다. 이 
통보문은 프로그람에서 창문내용을 다시 표시할 필요가 있을 때 보낸다. 이 통보문이 왜 
중요한가를 리해하기 위 하여 앞절에서 작성한 프로그람을 실행 하여 여러개 문자를 입력 
해 보자. 

다음에 창문을 최소화하였다가 다시 원래 크기로 해 보자. 본래의 크기로 복귀된 창 
문에는 입력된 문자가 표시되여 있지 않다는것을 알수 있다. 창문이 다른 창문밑에 가리 
웠다가 다시 표시된 경우에도 문자가 표시되지 않는다는것을 알수 있다. 

그 원인은 Windows 가 창문내용을 보관하지 않기때문이 다. 창문내용을 관리하는것 
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은 프로그람자체의 역할로 되여 있다. 이것을 프로그람적으로 실현할수 있도록 하기 위 
해 창문내용을 다시 그릴 필요가 제기될 때마다 WM_PAINT 통보문이 전송되도록 되여 
있다 .( 이 통보문은 창문이 처음으로 창조될 때도 발송된다.) 프로그람에서는 이 통보문 
을 받을 때 마다 창문내 용을 다시 그려야 한다. 

WM_PAINT 통보문에 응답하는 방법을 설명 하기 에 앞서 Windows 가 창문내용을 
자동적 으로 재 표시하여 주지 않는 리유를 알아두는것 이 좋을것 이 다. 그 리 유는 단 한가 
지 로서 임의의 상황에서 창문의 내 용을 잘 알고 있고 쉽게 다시 표시할수 있는것은 조작 
체계가 아니라 사용자가 작성하는 프로그람이기때 문이 다. 

WM_PAINT 통보문을 처 리 하자면 먼저 그것을 창문함수의 switch 문에 추가하여 야 
한다. 앞의 프로그람에 WM_PAINT 를 추가하는 례를 아래에 주었다. 

case WM_PAINT : // 재 표시요구를 처 러 한다 . 

hdc = BeginPaint (hwnd, Spaintstruct) : // 장치 상황을 얻 는다 . 

TextOut(hdc, 0, 0, strlen(str)) ; 

EndPaint(hwnd, &paintstruct) : // 장치 상황을 해 제 한다 . 
break ； 

프로그람코드를 상세하게 고찰해 보자. 우선 장치상황을 GetDc ( ) 가 아니 라 
BeginPaint ( ) 를 사용하여 얻 었 다는데 주목해 야 한다. 여 러 가지 리 유로 하여 
WM_PAINT 통보문을 처리할 때는 BeginPaint ( )를 사용하여 장치상황을 엄어야 한다. 
아래에 선언을 보여 주었다. 


HDC BeginPaint (HWND hwnd , PAINTSTRUCT * lpPS ) ; 


BeginPaint ( ) 는 호출에 성 공하면 장치 상황을 돌려 주고 실패하면 NULL 을 돌려 
준 다 . hwnd 는 장 치 상 황 을 얻 는 창 문 의 손 잡 이 이 다 . 두 번 째 파 라 메 터 는 
PAINTSTRUCT 구조체 의 지 시 자이 다. IpPS 에 는 프로그람에 서 창문을 재 표시 하는데 사 
용되는 정 보가 들어 있다. PAINTSTRUCT 는 다음과 같이 정의되 여 있다. 


typedef struct tagPAINTSTRUCT { 
HDC hdc ； 

BOOL fErase ； 

RECT rcPaint ； 

BOOL fRestore ； 


// 장치상황의 손잡이 

// 배경을 소거할 필요가 있는 경우 TRUE 
// 다시 그러는 4 각형령역의 자러표 
// 예 약 


BOOL flncUpdate; // 예 약 

BYTE rgbReserved[32] : // 예 약 

} PAINTSTRUCT ； 
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hdc 에 는 재표시할 펼 요가 있는 창문의 장치상황을 넣는다. 이 장치상황은 
BeginPaint ( )를 호출하여 돌려 지는 장치 상황과 같다. : fErase 는 창문배 경을 소거 할 필 
요가 있는 경 우에 령 이 아닌 값으로 된 다. 그러 나 창문작성 시 에 배 경붓을 지 정하면 
fErase 를 무시 할수 있다. Windows 2000 이 창문을 소거 해 주기때 문이 다. 

K 그 T 는 4 각형령역의 왼쪽웃모서 리와 오른쪽아래모서리의 자리표를 지정하기 위한 
구조체 이 다. 아래 에 그 내 용을 정 의 한다. 


typedef tagRECT { 

LONG left, top : // 왼쪽웃모서 리의 자리표 

LONG right, bottom ； //오른쪽아래모서 리 자리표 
} RECT ； 


PAINTSTRUCT 의 rcPaint 성 원은 창문내 부에서 다시 그릴 필요가 있는 4 각형령 역 
의 자리표를 보관한다. 여기에서는 창문전체를 다시 그리기하는것을 전제로 하고 있으므 
로 rcPaint 의 내용을 사용할 필요가 없다. 그러나 실제 프로그람들에서는 이 정보를 리 
용하는 때도 있다. 

장치상황을 엄으면 창문에 대한 출력 이 가능하게 된다. 창문의 다시 그리기가 완료되 
면 EndPaint ( ) 를 호출하여 장치 상황을 해 제 하여 야 한다. 아래 에 그 선언을 보여 주었 다. 


BOOL EndPaintCHWND hwnd , CONST PAINTSTRUCT * lpPS ); 


EndPaint ( ) 는 령을 돌려 준다. hwnd 는 다시 그린 창문의 손잡이 이 다. 두번째 파 
라메 터 는 BeginPaintC )를 호출할 때 사용한 PAINTSTRUCT 구조체 의 지 시 자이 다. 

BeginPa 加: () 를 사용하여 엄은 장치상황은 반드시 EndPaintC ) 를 사용하여 해제하 
여야 한다는것을 잊지 말아야 한다. 또한 BeginPaintC ) 는 抑^ PAOVr 통보문을 처리할 
때만 사용된다는것 역시 명심해 두어야 한다. 

WM_PAINT 통보문을 처 리하는 완성 된 프로그람을 실 례 3-4 에 주었 다. 


실 례 3-4. WM PAINT 프로그람 


// WM_PAINT 통보문의 처 리 


itinclude 〈 windows. h> 
ttinclude <cstring> 
^include <cstdio> 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
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char szWinName[] = ” My Win"; // 창문믈라스의 이름 

char str [255] = "Sample Output" : // 출력 할 문자렬을 보관한다 . 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

// 창문물라스를 정의 한다 . 

wcl. cbSize = sizeof (WNDCLASSEX) ; 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 

wcl.IpszMenuName = NULL ； // 를라스차림표는 없다 . 
wcl.cbClsExtra = 0 ； // 보조기 억기령 역은 없다 . 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 


// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


A 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow( 
szWinName, // 창문믈라스의 이름 
"Process WM_PAINT Messages", // 제목 
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WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, //창문의 너 비는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, //창문의 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

)； 


// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while(GetMessage(&msg , NULL, 0, 0)) 

{ 

TranslateMessage(&msg); // 건반통보를 변환한다 . 
DispatchMessage(&msg) ; // Windows 2000 에 조종을 넘 긴다 . 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 

static unsigned j=0 ； 

PAINTSTRUCT paintstruct ； 


switch (message) { 

case WM_CHAR ： // 건입 력을 처 리 한다 . 
hdc = GetDC(hwnd); // 장치상황을 얻는다 . 
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sprintf (str, " 초 c”, (char) wParam) ； // 문자를 문자렬로 한다 . 
TextOut(hdc, j*10, 0, str, strlen(str)) ； // 문자를 출력 한다 . 
j++; // 이 행을 설명문으로 해보시오 . 

ReleaseDC(hwnd, hdc) ； // 장치 상황을 해 제 한다 . 
break ； 

case WM.PAINT ： // 다시그러 기요구를 처 리 한다 . 
hdc = BeginPaint(hwnd, Spaintstruct) ； // 장치 상황을 얻 는다 . 
TextOut(hdc, 0, 0, str, strlen(str)) ； 

EndPaint(hwnd, &paintstruct) ； // 장치 상황을 해제 한다 . 
break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default : 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리 률 맡긴 다 . */ 
return DefWindowProc(hwnd, message, wParam, lParam); 


return 0 ； 

} 

앞으로 더 나가기 에 앞서 이 프로그람을 입 력하여 번역한 다음 그것 을 실행해 보자. 
어 떤 문자를 입 력 하고 창문을 최 소화하였 다가 다시 원래 크기 로 해 보자. 창문내 용이 다 
시 표시될 때마다 마감에 입력한 문자만이 자동적으로 다시 표시된다는것을 알수 있다. 
그 리유는 변수 str 에 마감에 입력한 문자만이 넣어지도록 되여 있기때문이 다. 

프로그람을 개 작하여 문자렬마감에 문자를 추가하고 WM_PAINT 통보문을 받을 때 
마다 그 문자렬을 표시 하도록 할수도 있다. (다음에 소개 하는 실례 프로그람에서 구체적 인 
방법을 보여 준다.) 

대 역 변수 str 는 프로그람의 기 동시 에 표시되는 “Sample Output ” 라는 문자렬 로 초기 
화되여 있다. 창문이 작성될 때도 WM_PAINT 통보문이 자동적으로 보내여 지므로 처 
음에 이 문자렬이 표시된다. 

이 프로그람에 서 WM_PAINT 통보문을 처 리하는 방법 은 단순하지 만 실지 프로그람 
에서는 약간 복잡하다. 왜냐면 대부분의 창문에서는 수많은 출력이 필요하기때문이다. 
창문의 크기가 변경되였거나 다른 창문밑에 숨겨졌을 때 그 내용을 본래대로 되살리는것 
은 사용자가 작성하는 프로그람의 역 할이므로 이것 을 실현하기 위 한 어떤 구조를 준비하 
여야 한다. 실지 프로그람에서는 이것을 다음과 갈은 세가지 방법으로 실현할수 있다. 


교육성 프로그람교육멘터 


61 



Windows 2000 프로그람작성 법 


첫 번째방법 은 다시 표시해 야 할 내 용을 계 산하여 얻 는것 이 다. 이 방법 은 사용자가 
입력을 하지 않는 프로그람인 경우에 가장 적합하다. 

두번째 방법은 어떤 상황에 있어서 사건들을 기록하여 놓았다가 창문을 다시 그릴 필 
요가 있을 때 그것을 재차 실행하는것이다. 

세번째 방법은 가상창문을 작성하여 다시 그릴 필요가 있을 때 그 내용을 실제 창문 
에 복사하는것 이 다. 세번째 방법 이 가장 일반적 인 방법 이 다. (이에 대해서는 뒤에서 설명 
한다.) 그러나 어느 방법이 최량인가 하는것은 응용프로그람의 목적에 의해 결정된다. 

이 책 에 보여 주는 대부분의 실례프로그람들은 창문의 다시그리기를 고려하지 않았 
다. 그것은 다시그리기를 고려하자면 많은 프로그람코드를 서술해야 하며 실례프로그람 
에서 설명 하려 고 하는 요점 이 불명 확해 지 기때 문이 다. 그러 나 실제 적 인 응용프로그람들에 
서는 Windows 2000 의 류의 에 따라 창문을 다시 그릴 필요가 있다. 


WM_PAINT 통보문의 생성 


프로그람에서 WM_PAINT 통보문을 생성시키는것도 가능하다. 처음에는 왜 프로그 
람에서 WM_PAINT 통보문을 생성 할 필요가 있을가 하고 의문을 가질수 있다. 또한 프 
로그람이 언제든지 창문을 다시 그릴수 있다고 생각하면 그것은 옳지 않다. 창문을 다시 
그리는것은 시 간이 걸 리는 처 리 라는것을 명 심하여 야 한다. 

Windows 는 다중과제체계이며 다른 프로그람이 CPU 시간을 요청할수도 있으므로 
프로그람측에서 Windows 에 정보를 출력하려고 한다는것을 전달하려는 경우에도 출력 
시점의 결정은 Windows 에 맡기는것이 최선의 수법이다. 이 수법을 사용하면 
Windows 는 체계의 모든 과제에 대하여 CPU 시간을 효률적으로 할당할수 있다. 

이 수법 을 사용하기 위 하여서는 WM_PAINT 통보문을 보내 올 때 까지 프로그람에서 
모든 출력내 용을 보관해 두어 야 한다. 앞에 서 본 실 례프로그람에 서 는 창문의 크기 가 변 
경되 였거 나 다른 창문밑 에 가리 웠다가 재표시 될 때 만 WM_PAINT 를 받도록 되 여 있었 
다. WM_PAINT 통보문이 전송되 여 올 때 까지 모든 출력내 용을 보관해 두고 통보문을 
받은 시 점 에서 사용자와 입 출력 을 진행하는 경 우에 는 어떤 출력내 용이 대 기 상태 에 있을 
때 창문에 WM_PAINT 통보문을 보낼 필요가 있다는것을 Windows 에 알려 주는 어 떤 
방법 이 있어야 할것 이 다. 

Windows 2000 은 이 요구에 따르는 기 능을 제 공하고 있 다. 그러 므로 프로그람이 정 
보를 출력하려는 시점 에서 Windows 의 형 편에 맞추어 WM_PAINT 통보문을 보낼것 을 
요구할수 있다. 

Windows 가 WM_PAINT 통보문을 발송하도록 하기 위해서 프로그람에서 
InvalidateRect ( ) 라는 API 함수를 호출한다. 아래 에 선언을 보여 주었 다. 
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BOOL InvalidateRect ( HWND hwnd , CONST RECT * lpRect , BOOL bErase ); 

hwnd 는 WM_PAINT 통보문을 전송할 대 상으로 되 는 창문의 손잡이 이다. RECT 구 
조체 인 IpRect 에는 창문내부의 다시 그리 려는 령역을 지정한다. 이 파라메터 가 NULL 
인 경 우에 는 창문전체 가 지 정 되는것으로 된다. bErase 가 TRUE 인 경우 배 경 이 소거 되 
고 령인 경우에는 배경이 소거되지 않는다. 호출이 성공한 경우에는 돌림값은 령이 아닌 
값으로 되며 성공하지 못한 경우에는 령으로 된다. InvalidateRect ( )를 호출하면 창문 
내용이 무효로 되며 다시 그릴 필요가 있다는것이 Windows 에 통지된다. 이렇게 되여 
Windows 가 프로그람의 창문함수에 WM_PAINT 통보문을 보내게 된다. 

모든 출력처리를 WM_PAINT 통보문처리에서 하도록 앞의 프로그람을 개조한 프로 
그람을 실 례 3-5 에 주었 다. WM_CHAR 통보문에 응답하는 프로그람코드는 매 개 문자를 
보관해 두고 InvalidateRect ( )를 호출하기 만 하도록 되 여 있 다. 이 프로그람에 서는 
WM_CHAR 에서 입력된 매개 문자를 str 라는 문자렬마감에 추가한다. 이렇게 하여 창문 
이 다시 표시될 때마다 마감에 입력된 문자만이 표시된 앞의 프로그람과는 달리 입력된 
모든 문자를 포함한 문자렬전체가 출력된다. 


실례 3-5. WM PAINT SKEL 프로그람 

/* WM_PAINT 통보문에서 출력을 진행 하는 
Windows 의 륜곽코드 */ 

ttinclude 〈 windows. h> 

^include <cstring> 
ttinclude <cstdio> 


LRESULT CALLBACK WindowFunc (HWND, UINT, WPARAM, LPARAM); 

char szWinNameG = "MyWin”; // 창문들라스의 이름 

char str[255] = ,M, ； // 출력 하려는 문자렬을 보관한다 . 

int WINAPI WinMain (HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 
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// 창문물라스를 정의 한다 . 

wcl. cbSize = sizeof (WNDCLASSEX) : 


wcl.Mnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문콜라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이 콘 

wcl. hlconSm = NULL ； // 큰 아이론의 축소판을 사용한다 . 

wcl. hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl. IpszMenuName = NULL ； // 믈라스차림표는 없다 . 
wcl.cbClsExtra = 0; // 보조기억기령역은 필요 없다 . 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) : 

// 창문콜라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문이 등록되였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Routing Output Through WM_PAINT", // 제목 
WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 창문의 너 비는 Windows 가 결정하게 한다 . 
CW_USEDEFAULT, // 창문의 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 
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// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) ； 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

TranslateMessage(&msg) ； // 건반통보를 변환한다 . 

DispatchMessage(&msg) : // Windows 2000 에 조종을 넘 긴다 . 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc(HWND hwnd, UINT message, WPARAM wParam, 
LPARAM IParam) 

{ 

HDC hdc ； 

PAINTSTRUCT paintstruct; 
char temp [2] ； 


switch (message) { 

case WM.CHAR ： // 건입 력 을 처 러 한다 . 
sprintf(temp, ”%c”, (char) wParam) ； // 문자를 문자렬로 한다 . 
strcat(str, temp); // 문자렬에 문자를 추가한다 . 

InvalidateRect(hwnd, NULL, 1); // 다시 그리기를 진행 한다 . 
break ； 

case WM.PAINT: // 다시 그리 기요구를 처 리 한다 . 
hdc = BeginPaint(hwnd, &paintstruct) ； // 장치 상황을 얻 는다 . 

TextOut(hdc, 0, 0, str, strlen(str ))； // 문자렬을 출력한다 . 

EndPaint(hwnd, &paintstruct) ； // 장치 상황을 해제 한다 . 
break ； 

case WM.DESTROY ： // 프로그람을 완료한다 . 
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PostQuitMessage (0) ; 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam); 


return 0 ； 


많은 응용프로그람들에서는 의뢰자구역에로의 모든(또는 대부분의) 출력을 
WM.PAINT 통보문에서 진행한다. 그 리 유는 이 미 설명 한것 과 같다. 그러 나 필요한 때 
임의의 시점에서 문자렬이나 도형을 출력할수도 있다. 어떠한 방법을 사용하는가는 프로 
그람의 목적에 의해 결정된다. 


I 다시 한보 전진| 


s 보문의 생성 

InvalidateRectC P \ WM_PAINT 통보문을 생 성 하는데 리 용된 다는것 을 앞에 서 
보았다. 그러 면 프로그람에서 일반적 인 통보문을 생성하려면 어 떻게 하면 좋겠는 
가 하는 새로운 의문이 생긴다. 그에 대한 대답은 간단하다. SendMessage ( ) 라는 
API 함수를 사용하는것이 좋다. SendMessage ( ) 함수를 사용하면 임의의 창문에 
통보문을 보낼수 있다. 아래에 선언을 보여 주었다. 

LRESULT SendMessage (HWND hwnd , UINT message , 

WPARAM wParam , LPARAM IParam ) : 

hwnd 는 통보문을 보내 려 는 창문의 손잡이 이 다. 통보문의 값은 message 에 
지정 한다. 통보문에 부가되는 정보는 wParam , IParam 에 넣 는다. 
SendMessage ( ) 는 통보문에 대한 응답을 돌려 준다. 

SendMessage ( ) 는 Windows 2000 의 조종체 (특히 공통조종체 )를 조작하는데 
자주 리용된다. 실제 사용법은 다음 장에서 나오는 여러 실례프로그람들에서 볼수 
있 다. 

물론 통보문을 보내 려 고 하는 모든 경우에 다 리 용하여도 관계 없다. 례 하면 아 
래에 표시한 WindowFunc ( ) 에서는 사용자가 [ Ctrl ] + [ A ] 건을 누를 때마다 련속적 
으로 WM_CHAR 통보문을 생성 하기 위 하여 SendMessage ( )를 사용한다. 
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LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam); 

{ 

HDC hdc ； 
unsigned i ； 
static unsigned j = 0; 
char s[ ] = “Hello There”; 
switch (message) { 

case WM.CHAR ： // 건입 력을 처 리 한다 . 

hdc = GetDC(hwnd) ； // 장치 상황을 얻 는다 . 

// 사용자가 [Ctrl] + [A] 건을 누르면 “Hello There” 라고 표시 . 
if ((char) wParam == (char) 1) for( i=0 ； s[i] ； i++) 
SendMessage(hwnd, WM_CHAR, (WPARAM) s[i], 
(LPARAM) 0); 

else { 

sprintf (str, “%c”, (char) wParam) ； // 문자렬을 작성 
TextOut(hdc, j*10, 0, str, strlen(str)) ； // 문자를 출력 


j ++ ; 

} 

ReleaseDC(hwnd, hdc); // 장치상황을 해제 
break ； 

case WM.DESTROY ： // 프로그람을 완료 
PostQuitMessage (0); 
break ； 
default ： 

//이 switch 문에 지정된것 이외의 통보문은 Windows 2000 에서 
// 처리된다 . 

return DefWindowProc(hwnd, message, wParam, IParam); 


return 0 ； 

} 


지금까지 본 프로그람들의 어느 하나의 창문함수를 이 WindowFunc ( )로 치 
환하면 [ Ctrl ] + [ A ] 건 이 눌러 울 때 마다 “ Hello There ” 라는 문자렬 이 련속적 인 
WM.CHAR 통보문으로 되여 프로그람에 전송된다. 이 수법은 프로그람에 건반마 
크로를 제공하는데 사용할수 있다. 
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다른 한가지 주목해야 할것은 WM_CHAR 통보문이 처리될 때 프로그람이 
IParam 을 참고하지 않으므로 SendMessage ( ) 호출에 서 는 이 파라메 터 를 간단히 0 
으로 하고 있다는것 이 다. 그러 나 다른 파라메터들의 내 용은 정 보를 전달하기 위 한 
적절한 값으로 할 필요가 있다. 


마우스들보문에 대한 응답 


Windows 2000 은 마우스를 기 본입 력 도구로 하는 조작체 계 이 므로 모든 Windows 
2000 프로그람은 마우스입 력 에 대응해 야 한다. 마우스통보문아는 여 러 가지 종류가 있다. 
이 장에서 취급하는 통보문들은 다음과 같다. 

WM_LBUTTONDOWN WM_LBUTTONUP WM_LBUTTONDBLCLK 
WM_RBUTTONDOWN WM_RBUTTONUP WM_RBUTTONDBLCLK 


대 다수 콤퓨터 들은 두개 의 단추를 가진 마우스를 사용하고 있지 만 Windows 2000 에 
서 는 3 개 의 단추를 가진 마우스까지 도 취 급한다. 매 단추를 왼쪽 단추, 가운데단추, 오 
른쪽 단추라고 한다. Windows 2000 에서는 응용프로그람에서 특정 한 지 령을 실행 하기 
위한 특수한 X 단추도 지 원하고 있지 만 여 기 에서는 설명하지 않는다. 이 장의 나머지 부 
분에서는 왼쪽 단추와 오른쪽 단추만을 취급한다. 

우 선 가 장 일 반 적 인 마 우 스 통 보 문 들 인 WM_LBUTTONDOWN 과 WM _ 
RBUTTONDOWN 을 설 명 하자. 

이 통보문들은 각각 왼쪽 단추와 오른쪽 단추가 눌러워 졌을 때 생성된다. 
WM_LBUTTONDOWN 혹은 WM_RBUTTONDOWN 발송되 는 경 우 마우스의 현재 X , 
Y 위치가 IParam 의 웃단어와 아래단어에 각각 보관된다. wParam 의 값은 다음 절에서 
설 명하는 다양한 상태 정 보를 보관한다. 

마우스통보문을 받은 때 IParam 에서 X , Y 자리 표를 엄 는 방법 에 는 두가지 가 있 다. 
첫번째 방법 은 HIWORD( )， Lowcrnx J 를 사용하는 보편적 인 방법 으로서 이 책 에서 
리 용한다. 두번째 방법 은 GET_X_LPARAM( )， G 公： T_F 이 라는 마크로를 사 

용하는 방법이다. 이 마크로들은 기본적으로 HIWORD , LOWORD 에 별명을 붙인것으 
로서 기 억 하기 쉽다. 아래 에 선언을 보여 주었다. 

int GET _ X _ LPARAM ( LPARAM IParam ) : 

int GET _ Y _ LPARAM ( LPARAM IParam ) : 


GET _ Y _ LPARAM ( ) 를 
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WINDOWS.H 를 인용하여야 한다. 이 책의 실례프로그람에서는 마우스통보문으로부터 
자리 표를 얻 는데 HIWORDC )， LOWORDi )% 사용한다. 

실 례 3-6 은 마우스통보문에 대 한 응답을 보여 주는 프로그람이다. 마우스유표가 프 
로그람창문내부에 있을 때 마우스단추를 누르면 마우스의 현재위치가 표시된다. 


실 례 3-6. MouseMsg 프로그람 

// 마우스통보문의 처 리 

♦include 〈 windows. h> 
ttinclude <cstrlng> 

♦include <cstdio> 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) : 
char szWinName[] = "MyWin”; // 창문콜라스의 이름 
char str[255] = ""； // 출력할 문자렬을 보관한다 . 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 


// 창문클라스를 정의한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) : 

wcl.hlnstance = hThisInst; // 실체의 손잡이 

wcl. IpszClassName = szWinName ； // 창문콜라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이콘 

wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 

wcl. hCursor = LoadCursor (NULL, IDC_ARROW) ； // 유표의 형 식 
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wcl.lpszMenuName = NULL ； // 콜라스차림표는 없다 . 
wcl.cbClsExtra = 0 ； // 보조기억기령역은 필요 없다 . 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 

// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문믈라스의 이 름 
"Processing Mouse Messages", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Wtadows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 창문의 너 비는 Windows 가 결정하게 한다 . 
CW_USEDEFAULT, // 창문의 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

)； 


// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) : 

UpdateWindow (hwnd) : 

// 통보문순환고리를 작성 한다 . 

while(GetMessage (&msg, NULL, 0, 0)) 

f 

TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage(Smsg) : // Windows 2W)0 에 조종을 넘 긴다 . 

} 
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return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받는다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 
switch (message) { 

case WM.RBUTTONDOWN : // 오른쪽 단추를 처 리 한다 . 
hdc = GetDC(hwnd) ； // 장치 상황을 얻 는다 . 
sprintf(str, "Right button is down at %d, %d", 

LOWORD (IParam), HIWORD (IParam)) ； 

TextOut (hdc, LOWORD (IParam), HIWORD (IParam), 
str, strlen(str)) ； 

ReleaseDC(hwnd, hdc); // 장치상황을 해제한다 . 
break ； 

case WM.LBUTTONDOWN : // 왼쪽 단추를 처 리 한다 . 
hdc = GetDC(hwnd) ； // 장치 상황을 얻 는다 . 
sprintf (str, "Left button is down at %d, 

LOWORD (IParam), HIWORD (IParam)); 

TextOut (hdc, LOWORD (IParam), HIWORD (IParam), 
str, strlen(str)) ； 

ReleaseDC(hwnd, hdc) ； // 장치 상황을 해 제 한다 . 
break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 이 처 리 하게 한다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 

} 


return 0 ； 

} 
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그림 3-4 는 프로그람의 실행결과를 보여 준다. 



^JnJxJ 

Left button is down at 28, 20 

Right button is down at 54, 53 

Left button 

Left button is down at 118, 90 

Right button is down at AA, 136 

Left button is ( 


그림 3-4. 마우스통보문프로그람의 실행 결 과 


마우스통보문의 상세 

이 장에서 설명 하는 모든 마우스통보문에서는 IPara 과 wParam 에 같은 정 보가 보 
관되여 있다. 이미 설명한바와 같이 IParam 에는 통보문이 생성된 때의 마우스자리표가 
보관되여 있다. wParam 에는 마우스, 건반상태와 관련한 정보가 보관되여 있다. 이것은 
아래에 보여 준 값들의 조합으로 된다. 


■—CONTROL 

■—SHIFT 

MK_MBUTTON 

MK_RBUTTON 

MK-LBUTTON 

MK_XBUTTONl 

MK_XBUTTON2 

마우스단추와 동시 에 [Ctrl] 단추가 눌러 워 져 있는 경우에는 wParam 에 
MK—CONTROL 이 보관된다. 마우스단추와 동시 에 [Shift] 단추가 눌러 워 져 있는 경 우 
에 는 wParam 에 MK_SHIFTA 보관된 다. 

또한 왼쪽 단추가 눌러워 졌을 때 동시에 오른쪽 단추가 눌러워 져 있는 경우에는 
wParam 에 MK_RBUTTON。' 보관된다. 오른쪽 단추가 눌러워 졌을 때 동시에 왼쪽 단 
추가 눌러워 져 있는 경우에는 wParam 에 MK—LBUTTON。' 보관된다. 왼쪽 혹은 오른 
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쪽 단추가 눌러워 졌을 때 동시 에 가운데단추가 눌러워 져 있는 경우에는 wParam 에 
MK _ MBUTTON 아 보관된다. 

어떤 X 단추가 눌러워 진 경우에는 MK_XBUTTONl 혹은 MK _ XBUTTON 2 보관 
된 다. 

Windows 2000 으 I 새로운 기능 : MK_XBUTTONl 과 MK _ XBUTTON 2 는 Windows 
2000 에 새로 추가된것 이 다. 

단추■음를보문의 사용 

마우스단추 7 \ 한번 찰칵되면 프로그람은 두개의 통보문을 받는다. 하나는 단추가 눌 
리 워 졌 다는것 을 가리 키 는 WM _ LBUTTONDOWN 과 같은 단추누 S 통보문이 五 다른 하 
나는 누른 단추를 놓았다는것 을 가리키 는 단추놓음통보문이 다. 왼쪽 단추와 오른쪽 단추 
놓음통보문은 각각 WM_LBUTTONUP 과 WM_RBUTTONUP 다. 

항목을 선택하는것 과 같은 조작을 수행하는 응용프로그람들에서 는 단추누름통보문보 
다 단추놓음통보문을 사용하는것 이 좋다. 그것은 단추를 누른후에도 사용자가 선택을 취 
소할수 있기때문이다. 

두번 찰칵에 대한 옹답 

한번찰칵에 응답하는것 은 간단하지 만 두번 찰칵을 취 급하는것은 약간 복잡하다. 우 
선 프로그람에서 두번 찰칵을 받는 설정을 해야 한다. 암시적으로는 프로그람에 두번 찰 
칵통보문이 전송되지 않는다. 다음 두번 찰칵통보문에 응답하는 프로그람코드를 추가해 
야 한다. 

프로그람이 두번 찰칵통보문을 받도록 하려 면 창문들라스를 등록하기전에 
WNDCLASSEX 구조체 의 Style 성 원에 CS—DBLCLKS 를 지정 하는것 이 필요하다. 이를 
위해 아래와 같은 프로그람코드를 서술한다. 

wcl. style = CS_DBLCLKS ； // 두번 찰칵을 허 가한다 . 

두 번 찰 칵 을 가 능 하 게 하 면 프 로 그 람 이 WM_LBUTTONDBLCLIK 나 WM _ 
RBUTTONDBLCLIK 등와 두번 찰칵&보문을 받을수 있게 된다. lParam 과 wParam 의 
내용은 다른 마우스통보문들과 같다. 

두번 찰칵이 한 짧은 순간에 마우스단추를 두번 반복하여 누르는것 이 다. 마우스단추 
를 두번 찰칵하여 두번 찰칵통보문을 발생시키기 위한 시간간격올 얻을수도 있고 설정 할 
수도 있 다. 두번 찰칵을 위 한 시 간간격 을 얻 으러 면 GetDoubleClickThne ( ) 라는 API 함 
수를 사용한다. 아래 에 선언을 보여 주었다. 

UINT GetDoubleClickTime ( void ) : 
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이 함수는 두번 찰칵을 발생시키기 위한 시간간격의 웃한계를 ms 단위로 돌려 준다. 
두번 찰칵의 시 간간격 을 설 정 하는데 는 SetDoubleClickT 加 e ( ) 을 사용한다. 아래 에 선 언 
을 보여 주었다. 

UINT SetDoubleClickTime (UINT interval ) : 

interval 에는 두번 찰칵을 발생시키기 위 한 시간간격의 웃한계를 ms 단위로 설정한다. 
0 을 설정 하면 체 계설정의 시 간간격 이 사용된다. (체 계설정 의 시 간간격 은 약 0.5 s 이 다. ) 
함수의 호출이 성 공하면 0이 아닌 값을 돌려 주며 실패하면 0이 돌려 진다. 실례 3-7 의 
프로그람은 두번 찰칵통보문에 응답하는 프로그람이 다. 이 프로그람은 
GetDoubleClickTimeC ) 및 SetDoubleClickTime ( ) 의 응용실례로도 된다. 

웃방향화살건을 누르면 두번 찰칵의 시간간격 이 증가한다. 아래방향화살건을 누르면 
시 간간격은 감소한다. 마우스의 오른쪽 단추 또는 왼쪽 단추중의 어느 하나를 두번 찰칵 
하면 현재의 두번 찰칵시간간격을 표시하는 통보칸이 표시된다. 

두번 찰칵시 간간격은 체계전체 에 적용되는 설정이므로 값의 설정 이 체계의 모든 프 
로그람들에 영향을 미친다. 이로부터 프로그람의 기동시에 현재의 두번 찰칵시간간격을 
보관해 둔다. 일반적 으로 응용프로그람들에 서 동작과정 에 체계의 설정을 변경하였다면 
프로그람의 완료시에 원래의 상태로 복귀해 놓아야 한다. 


실례 3-7. DblClick 프로그람 

// 두번찰칵에 대한 응답 및 두번 찰칵시간간격의 조작 

ttinclude 〈 windows. h> 

^include <cstring> 
itinclude <cstdio> 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM); 

char szWinNameG = n MyWin”; // 창문들라스의 이름 

char str[255] = // 표시 할 문자렬을 보관한다 . 

UINT OrgDblClkTime ； // 본래의 두번 찰칵시 간간격을 보관한다 . 

int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 
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{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

// 창문물라스를 정의 한다 . 

wcl. cbSize = sizeof (WNDCLASSEX) ; 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 

wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 

wcl. lpfnWndProc = WindowFunc ； // 창문함수 

wcl. style = CS_DBLCLKS ； // 두번 찰칵을 허가한다 . 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ; // 큰 아이콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 

wcl.IpszMenuName = NULL ； // 를라스차림표는 없다 . 
wcl.cbClsExtra = 0 ； // 보조기억기령역은 필요 없다 . 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색은 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 


// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


A 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow( 
szWinName, // 창문믈라스의 이름 
"Processing Double-Clicks", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자리 표는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 창문의 너 비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 창문의 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 
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NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

)； 


// 현재의 두번 찰칵시간간격을 보관한다 . 
OrgDblClkTime = GetDoubleClickTime ( )； 


// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd) ； 

// 통보문순환고리률 작성 한다 . 

while(GetMessage (&msg, NULL, 0, 0)) 

{ 

TranslateMessage(&msg) : // 건반통보률 변환한다 . 
DispatchMessage(&msg) ； // Windows 2000 에 조종을 넘 긴다 . 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받는다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 

UINT interval ； 

switch (message) { 
case WM.KEYDOWN ： 

if ((char) wParam == VK_UP) { // 시간간격을 중가시킨다 . 
interval = GetDoubleClickTime ( ); 
interval += 100; 

SetDoubleClickTime (interval); 
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if((char)wParam == VK.DOWN) { // 시간간격을 감소시킨다 . 
interval = GetDoubleClickTime ( ); 
interval -= 100; 
if (interval < 0) interval = 0; 

SetDoubleClickTime (interval); 

} 

sprintf(str, "New interval is %u milliseconds", 
interval) ； 

MessageBox(hwnd, str, "Setting Double-Click Interval", 

MB_OK); 

break ； 

case WM.RBUTTONDOWN : // 오른쪽 단추를 처 러 한다 . 
hdc = GetDC(hwnd); // 장치상황을 얻는다 . 
sprintf(str, "Right button is down at %d, %d", 

LOWORD (IParam), HIWORD (lParam)) ； 

TextOut (hdc, LOWORD (IParam), HIWORD (IParam), 
str, strlen(str)) ； 

ReleaseDC(hwnd, hdc) ； // 장치 상황을 해제 한다 . 
break ； 

case WM.LBUTTONDOWN : // 왼쪽 단추를 처 리 한다 . 
hdc = GetDC(hwnd) ； // 장치 상황을 엄는다 . 
sprintf (str, "Left button is down at %d, 

LOWORD (IParam), HIWORD (IParam)); 

TextOut (hdc, LOWORD (IParam), HIWORD (IParam), 
str, strlen(str)) ； 

ReleaseDC(hwnd, hdc) ； // 장치 상황을 해 제 한다 . 
break ； 

case WM.LBUTTONDBLCLK : // 왼쪽 단추의 두번 찰칵을 처 리 한다 . 
interval = GetDoubleClickTime ( ) ； 
sprintf(str, "Left Button\nlnterval is %u milliseconds", 
interval); 

MessageBox(hwnd, str, "Double Click", MB_OK) ； 
break ； 

case WM.RBUTTONDBLCLK : // 오른쪽 단추의 두번 찰칵을 처 리 한다 . 
interval = GetDoubleClickTime ( ) ； 

sprintf(str, "Right Bu 竹 on\nlnterval is %u milliseconds”, 
interval) ； 

MessageBox(hwnd, str, "Double Click”, MB_OK) ； 
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break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 
SetDoubleClickTime(OrgDblClkTime) ； // 시 간간격 을 본래 대 로 복귀 한다 . 
PostQuitMessage (0) ; 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문들은 
Windows 2000 이 처 리 하게 한다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam); 


return 0 ； 


이 프로그람의 실행 결과는 그림 3-5 와 같다. 



그림 3-5. 두번 찰칵프로그람의 실행결과 


기타 통보문들 


처음에 설명하였던것처럼 Windows 2000 은 이 장에서 설명한것외에도 많은 통보문을 
생성한다. 다른 통보문들에 대해서는 이 책의 나머지 부분에서 필요에 따라 설명한다. 
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제 4 장 


차림표의 기초 


이 장에서부터 Windows 2000 의 사용자대면부에 대한 설명을 시작한 
다. 일반적으로 Windows 응용프로그람에서는 몇가지 미리 정의된 구성요 
소들을 리용하여 사용자와 정보를 주고 받는다. 이러한 구성요소들은 
Windows 에 정의되여 있으며 그 종류도 다양하다. 

이 장에서는 가장 기본적인 구성요소인 차림표에 대해 소개한다. 실제 
로 작성하는 프로그람에서는 차림표를 사용하는것 이 보편적 이 다. 뒤 에서 
보게 되지만 차림표의 기본적인 설계는 미리 정의되여 있다. 응용프로그람 
과 관련되는 고유한 정보만을 추가하면 된다. 차림표가 중요한 구성요소이 
므로 Windows 2000 은 차림표를 지원한다. 차림표의 기능은 아주 풍부하 
며 이 장에서는 기초지식만을 설명 하고 차림표의 고급한 기능에 대하여서 
는 제 19 장에 서 설 명한다. 

이 장에서는 자원에 대 해서 도 소개한다. 刀운/이 란 프로그람의 외부에 
정의되여 있으면서 프로그람에서 사용되는 객체이다. 일반적으로 아이콘， 
유표，비 트매 프 및 차림 표 등이 자원 으로 된다. 자원은 거 의 모든 
Windows 응용프로그람에서 사용되는 중요한 요소이 다. 
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차림표의 기초지식 


일 반적 인 Windows 프로그람의 조작에 서 공통적 인 요소는 차림 표이 다. Windows 
2000은 일반적 인 세 가지 형 식의 차림표를 지 원한다. 

• 차림 표띠 (또는 기본차림 표) 

• 튀여나오기부분차림표 

•독립된 유동튀여나오기차림표 

Windows 응용프로그람에서는 창문의 제일 웃부분에 차림표띠가 표시된다. 이것을 
기본차림표타히 한다. 차림표띠는 응용프로그람의 제 일 웃준위 의 차림 표이다. 차림 표 
띠 로부터 부분차림 표가 내 리펼 치기되거 나 뭐 여 나오기차림표로서 표시된다. 유동투I여나오 
기차림^한 마우스의 오른쪽 단추를 누를 때 표시 되 는 독립 적 인 차림 표이다. 

이 장에 서 는 차림 표띠 와 뤄여나오기부분차림표야 대 하여 설명 하며 유동뭐 여 나오기 차 
림표에 대해서는 다음 장에서 취급한다. 프로그람의 기본창문에 차림표띠를 추가하는것 
은 아주 간단하며 아래와 같은 세 단계로 진행한다. 

• 자원파일에서 차림 표의 구조를 정의 한다. 

• 프로그람이 기본창문을 작성할 때 차림표를 적재한다. 

• 차림표를 선택하였을 때의 처리를 진행한다. 

이 장의 나머지 부분들에서는 이 단계들이 실제로 어떻게 진행되는가를 알수 있다. 

자 원 


Windows 는 몇가지 공통된 형식의 객체를 자원으로 정의한다. 이미 설명한바와 같 
이 J / 관이 란 프로그람에서 러용되는 기본적 인 객체이며 프로그람의 외부에서 정의된다. 
차림표는 자원의 일종이다. 자원은 프로그람과는 별개로 작성되며 프로그람을 련결할 때 
EXE 파일 에 추가된 다. 

자원은 .RC 라는 확장자를 가지는 자원 W 일 (RC 파알) 안아서 정의된다. 소규모의 프 
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로젝 트라면 자원파일의 이 름을 EXE 파일의 이 름과 같게 정 의 하는것 이 일 반적 이 다. 실례 
로 프로그람의 이름이 PROG.EXE 라면 자원파일의 이름은 PROG.RC 로 한다. 물 
론 .RC 라는 확장자만 가진다면 자원파일에 임의의 이름을 붙여도 된다. 

자원의 종류에 는 일 반적 인 본문편집 기 로 작성할수 있는 본문형 식도 있다. 본문형 식 
의 자원은 자원파일안에서 정의된다. 아이콘 등과 같은 본문형식이 아닌 자원도 있으며 
자원편집기를 사용하여 쉽게 작성할수 있다. 그러나 그 존재를 응용프로그람의 자원파일 
안에 명기하여야 한다. 이 장에서 작성하는 자원파일은 본문형식뿐이다. 왜냐면 차림표 
는 본문형식의 자원이기때문이다. 

자원파일안에 서 는 C / C ++ 의 명 령 문을 사용할수 없 다. 그대 신 자원파일 독자의 명 령 
문을 사용한다. 이 장에 서 는 차림 표를 작성 하는데 필 요한 명 령 문들만을 설 명하며 그밖의 
명 령 문들은 필 요한 때 설 명한다. 

RC 파일의 번역 

자원파일은 그대로는 프로그람에 추가할수 없다. 그 러유는 자원파일을 련결가능한 
형 식 으로 변환하여 야 하기 때 문이 다. RC 파일 을 작성하면 자원번역프로그람느로 번역하여 
그것을 RES 파일로 변환한다. (일반적인 자원번역프로그람의 이름은 RC.EXE 이지만 다 
른 경우도 있다.) 

자원파일을 번역하는 방법은 사용하는 번역기에 따라 다르다. 그러나 대표적인 통합 
개 발환경들에서는 이 처 리를 자동화하고 있다. 실례 로 Microsoft Visual C ++ 에서는 자원 
파일의 번역과 련결이 자동적으로 진행되게 되여 있다. 여하튼 자원번역프로그람의 출력 
은 RES 파일 이 며 프로그람에 련결하여 야 한다. 

간단한 차림표의 작성 


차림 표는 자원파일 안에 서 MENU A 는 명 령 문을 리 용하여 정 의 한다. 모든 차림 표에 
대해서 아래와 같은 공통적인 구문이 쓰인다. 


MenuName MENU [ options ] 

{ 

menu items 

} 


MenuName 은 차림표의 이름이 다. (차림표를 식별하기 위한 옹근수값으로도 할수 
있지만 이 책의 실례프로그람에서는 차림표를 참조하기 위해서 이름을 사용한다.) 
MENU 라는 열쇠단어 는 자원번역프로그람야 차림 표의 작성 을 요구한다. Windows 2000 
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프로그람에서 options 에 지 정할수 있는 선택 항목은 몇 개 되 지 않는다. 아래 에 가능한 
선택항목들을 표시하였다. 


선택항목 의 미 

CHARACTERISTICS info 

info 에 DWORD 로서 응용프로그람자체 의 정 

보를 지 정한다. 

LANGUAGE lang , sub-lang 

lang 과 sub-lang 에 자원에서 사용하는 언어 

를 지정한다. 

VERSION ver 

ver 에 DWORD 로 응용프로그람의 판번호를 

지정 한다. 


간단한 응용프로그람에서는 이 선택항목들을 사용하지 않고 보통 체계설정을 사용한다. 

이식과 관련한 요점 : 16 bit 의 Windows 3.1 에서는 MENU 명령문에 지정 할수 있는 선 
택 항목으로서 PRELOAD 등이 있었다. 이 항목은 Windows 2000 에서는 의미를 가지 
지 못한다. 그러므로 프로그람을 이식하는 경우에는 이러한 낡은 선택항목을 제거하여 
야 한다. 

차림표를 정의하기 위 해서 두개의 명령문 MENUITEM 파 ■ POPUP 를 리 용한다. 
MENUITEM 은 최 종적 으로 선택 되 는 차림 표의 항목을 지 정 한다. POPUP 는 튀 여 나오기 
부분차림 표를 지 정하며 또한 그 안에 MENUITEM 이 나 POPUP 를 포함할수도 있 다. 이 
명령문들을 사용한 일반적인 구문은 아래와 같다. 

MENUITEM “ ItemName”，MenID [ , Options ] 

POPUP “ PopupName ” [ ， Options ] 

ItemName 은 [ Help ] 나 [ File ] 등과 같은 차림표의 항목을 선택할 때의 이름이다. 
MenID 는 차림 표의 항목과 관련된 유일 한 옹근수값으로서 차림 표가 선택 될 때 응용프로 
그람에 발송된다. 

일반적으로 이 값은 머려부파일안에 마크토로서 정의하여 응용프로그람의 원천파일 
과 자원파일의 량쪽에 다 포함시 킨다. PopupName 은 튀 여 나오기차림 표의 이 름이 다. 어 
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느 구문에서 도 options 의 값은 표 4-1 에 표시 한것과 같다. (이것들은 WINDOWS . H 를 
포함시 켜 정 의한다. ) 


표 4-1. MENUITEM 과 POPUP 의 선택 


CHECKED 

차림 표항목과 나란히 검사표식 이 표시된다. (제 일 
웃준위 차림표에서는 지정할수 없다.) 

GRAY 

차림표항목이 회색으로 표시되여 선택 불가능한 
상태로 된다. 

HELP 

도움말과 관련된다는것 을 표시 한다. 

INACTIVE 

차림표항목선택 을 불가능하게 한다. 

MENUBARBREAK 

차림표띠의 경우는 차림표항목을 개행하여 표시한 
다. 튀여나오기차림표의 경우는 차림표의 항목을 
다른 렬에 표시한다. 이 경우에는 차림표의 항목이 
분할띠로 나뉘여진다. 

MENUBREAK 

분할띠가 사용되지 않는다는 점을 제외하면 
MENUBARBREAK 와 같다. 

SEPERATOR 

분리 기 로 되 는 빈 차림 표항목을 작성한다. 
MENUITEM 에만 지 정 할수 있 다. 


뒤에 소개하는 실례프로그람에서 사용되고 있는 차림표의 정의를 아래에서 보여 주 
었 다. 이것은 MENU.RC 라는 파일 이다. 


// 차림표 실례자원파일 
^include “menu.h” 

MyMenu MENU 
{ 

POPUP “&File” 

{ 

MENUITEM “&Open”, IDM_OPEN 

MENUITEM “&Close” ， IDM_CLOSE 
MENUITEM “E&xit”,IDM_EXIT 

} 

POPUP ^Options" 

{ 

MENUITEM “&Colors”, IDM_COLORS 
POPUP “^Priority” 
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{ 

MENUITEM “&Low* ，， IDM_LOW 
MENUITEM “&High” ， IDM_HIGH 

} 

MENUITEM “&Fon1;s ，，， IDM_FONT 
MENUITEM “&Resolu 仕 on”, IDM_RESOLUTION 

} 

MENUITEM “&Help ，，， IDM_HELP 


이 차림표의 이름은 MyMenu 이며 [ File ], [ Options ], [ Help ] 세개의 웃준위차림표 
를 가지 고 있 다. [ File ] , [Op 仕 ons ] 에 는 튀 여 나오기 부분차림 표가 있 다. [ Priority ] 라는 
항목은 자기의 부분차림표를 가전다. 

부분차림표를 가지는 항목에는 차림표 ID 가 없다는데 주의해 야 한다. 실제로 선택 
되는 차림 표항목만이 ID 를 가진다. 이 차림 표에서는 모든 차림 표 ID 값이 IDM 으로 시 
작되는 마크로로 정의되 여 있다. (이 마크로는 MENU.H 라는 머 리부파일에 정의되 여 있 
다.) 이런 마크로명은 프로그람과 자원의 중개자로 된다. 

차림 표항목이 름가운데 에 있는 &기 호는 지 름건을 지정 하는것 이 다. 지 름건을 사용하면 
차림 표가 능동상태 로 된 때 건을 눌러 차림 표항목을 선택할수 있 다. 반드시 차림 표항목 
이름앞에 &기호를 사용해 야 하는것은 아니지만 다른 문자와 중복되지 않으면 선두에 놓 
는다. 그러나 [ Exit ] 와 같이 선두문자가 아닌 문자에 사용되는 경우도 있다. 

MENU.RC 에서 보여 주는바와 같이 자원파일에는 C 八：++형식의 설명문을 포함시 킬 
수도 있다. 

MENU.RC 에 포함되 여 있는 머 리부파일 MENU.H 에 는 차림표의 ID 값을 정의 하는 
마크로가 서술되여 있다. 그것을 아래에 주었다. 


ttdefine IDM_OPEN 100 

♦define IDM—CLOSE 101 

#define IDM_EXIT 102 

ttdefine IDM_COLORS 103 

#define IDM_LOW 104 

#define IDM_HIGH 105 

ttdefine IDM_FONT 106 

♦define IDM_RESOLUTION 107 

#define IDM_HELP 108 
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이 파일은 매 차림표항목이 선택된 때 돌려 주는 차림표 ID 값을 정의한다. 이 파일 
은 차림표를 사용하는 프로그람에도 포함된다. 차림표항목에 주어 진 이름이나 값은 중 
개자로 되며 매개 값은 유일해 야 한다. ID 값범위는 1〜況535로 되여 야 한다. 

프로그람에 차림표를 설치하기 


완성 된 차림 표를 프로그람에 설 치 하는 가장 간단한 방법 은 창문들라스를 작성할 때 
차림 표이 름을 지 정하는것 이 다. 이 경 우에 는 차림 표이 름의 문자렬지 시 자를 보관하는 
lpszMenuName 을 사용한다. 례 하면 MyMenu 라는 이 름의 차림 표를 사용하면 창문콜라 
스정의를 아래와 같이 한다. 

wcl . IpszMenuName = “ MyMenu ”; // 기본차림표 

이렇게 하면 MyMenu 는 이 콜라스를 기초로 하여 작성되는 모든 창문의 체계설정차 
림표로 된다. 이것은 이 클라스의 모든 창문이 MyMenu 로 정의된 차림표를 가진다는것 
을 의미한다. (콜라스에서 정의된 차림표를 다른 차림표에 덧쓰기변경하는것도 가능하다.) 

차림표선택에 대한 응답 


사용자가 차림 표를 선택 하면 프로그람창문함수에 1찌 02 MM 4 八取 통보문이 발송된 
다. 이 통보문을 받는 때 는 LOWORD ( wParam ) 에 차림 표항목의 ID 값이 넣 어 져 있 다. 
즉 LOWORD ( wParam ) 는 RC 파일에 정의된 차림표항목에 대응한 값을 가리키게 된다. 

어떤 차림표 항목을 선택 한 때도 WM_COMMAND 통보 문이 발송 되며 
LOWORD ( wParam ) 에는 차림표항목에 대응한 값이 보관되여 있으므로 선택된 차림표 
항목을 알려 면 겹 쌓임 switch 문을 사용하면 된 다. 례하면 다음의 프로그람코드는 
MyMenu 라는 차림 표선택 에 응답한다. 


switch (message) { 
case WM_COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM_OPEN ： 
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MessageBoxChwnd, "Open File”, "Open", MB 一 OK); 
break ； 

case IDM_CLOSE: 

MessageBox(hwnd, "Close File", ” Close”, MB_OK) ； 
break ； 

case IDM_EXIT: 

response = MessageBox(hwnd, "Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O) ； 
break ； 

case IDM_COLORS ： 

MessageBox(hwnd, "Set Colors", "Colors”, MB_OK) ； 
break ； 

case IDM_LOW : 

MessageBox(hwnd, ” Low”, "Priority", MB_OK) ； 
break ； 

case IDM.HIGH ： 

MessageBox(hwnd, ” High”, ， ’ Priority", MB_OK) ； 
break ； 

case IDM.RESOLUTION ： 

MessageBox(hwnd, "Resolution Options", 
’’Resolution", MB_OK) ； 

break ； 

case IDM_FONT: 

MessageBox(hwnd, "Font Options", "Fonts”, MB 一 OK); 
break ； 

case IDM_HELP: 

MessageBox(hwnd, "No Help’，, "Help”, MB_OK); 
break ； 

} 


설명을 간단히 하기 위하여 매개 차림표항목이 선택된 때의 응답은 단순히 화면에 
통보칸을 표시하는것 뿐이 다. 물론 실제 의 응용프로그람에 서 는 매 개 항목에 대 하여 고유 
한 처리를 진행해 주어야 한다. 
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간단한 차림표프로그람 


앞에서 정의한 차림표를 리용한 실례프로그람을 실례 4-1 에 주었다. 이 프로그람의 
실행결과는 그림 4-1 에 주었다. 

실례 4-1. Menu 프로그람 
// 차림 표의 리용실례 


ttinclude < windows. h> 

♦include <cstrlng> 

♦include <cstdio> 
ttinclude "menu, h" 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) : 
char szWinName[] = "MyWin”; // 창문콜라스의 이름 

int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

// 창문물라스를 정의 한다 . 

wcl. cbSize = sizeof (WNDCLASSEX) : 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. li 犯 zClassName = szWinName ； // 창문콜라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0 ； // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 


// 차림표자원을 지정 한다. 
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wcl. IpszMenuName = "MyMenu" : 

wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색은 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 

// 창문들라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


// 창문을 작성 한다 . 
hwnd = CreateWindow( 
szWinName, // 창문클라스의 이름 
"Introducing Menus", // 창문의 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CW_USEDEFAULT, // X 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 창문의 너 비는 Windows 가 결정하게 한다 . 
CW_USEDEFAULT, // 창문의 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메터 는 없 다 . 

)； 


// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) ; 

UpdateWindow (hwnd) : 

// 통보문순환고리를 작성 한다 . 

while(GetMessage (&msg, NULL, 0, 0)) 

{ 

TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage(&msg) : // Windows 2(K)0 에 조종을 넘 긴다 . 

} 
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/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받는다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

int response ； 

switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM_OPEN: 

MessageBoxChwnd, "Open File' "Open", MB_OK) ； 
break ； 

case IDM—CLOSE: 

MessageBox(hwnd, "Close File", ” Close”, MB_OK); 
break ； 

case IDM—EXIT: 

response = MessageBox(hwnd, "Quit the Program?", 

” Exit”, MB_YESNO) ； 
if (response == ID YES) PostQuitMessage(O) ； 
break ； 

case IDM—COLORS: 

MessageBox(hwnd, "Set Colors", ’’Colors”, MB_OK) ； 
break ； 

case IDM_LOW ： 

MessageBox(hwnd, "Low", "Priority", MB_OK) ； 
break ； 

case IDM—HIGH: 

MessageBox(hwnd, ’’High”, "Priority", MB_OK); 
break ； 

case IDM—RESOLUTION: 

MessageBox (hwnd, ” Resolution Options ” , 
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"Resolution", MB_OK) ； 

break ； 

case IDM_FONT： 

MessageBox(hwnd, "Font Options”, "Fonts”, MB_OK) ； 
break ； 

case IDM_HELP： 

MessageBox(hwnd, "No Help，，, ” Help”, MB_OK); 
break ； 

} 

break； 

case WM_DESTROY： // 프로그람을 완료한다. 

PostQuitMessage (0) ； 
break； 
default： 

/* 이 switch 문에서 지정된것 이외의 통보문들은 
Windows 2000 이 처 리 하게 한다. */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 


return 0； 

} 

그림 4-1 은 이 프로그람의 실행결과이다. 



그림 4-1. 차림표프로그람의 실행결과 
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|다시 한보 전진| 


MessageBox( ) 의 돌림값의 참조 

차림표실례프로그람에서는 사용자가 [ Exit ] 를 선택한 때 다음의 프로그람코 
드를 실행한다. 

case IDM _ EXIT ： 

response = MessageBox ( hwnd , “Quit the Program ?”, 

“ Exit ”, MB — YESNO ); 
if (response == ID YES ) PostQuitMessage (0) : 
break ； 

이 코드에 의해 아래의 통보칸이 표시된다. 



우의 그림을 보면 통보칸에는 [ Yes ], [ No ] 라는 두개의 단추가 있다. 3장에 
서 설명한바와 같이 MessageBox ( ) 는 사용자의 응답을 돌려 준다. 이 경우에 
는 MessageBox ( ) 의 모든 돌림값이 IDYES 또는 IDNO 가 될수 있다. 사용자 
의 응답이 IDYES 인 경우 프로그람을 완료한다. 그렇지 않은 경우에는 프로그 
람실행을 계속한다. 

이것은 통보칸을 사용하여 사용자에게 두가지 선택안을 주는 경우의 실례 이 
다. Windows 2000 프로그람을 작성 할 때 그리 많지 않은 선택 안을 사용자에 게 
주는 상황에서는 통보칸을 사용하는것이 편리하다. 


차림표에 지름건들 추가 


차림표와 관련하여 자주 사용되는 기능이 Windows 에 있다. 그것은 지름건이 다. 
지름건이 란 차림표항목이 표시되여 있지 않는 때도 차림표항목의 선택을 가능하게 하는 
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특수한 건 입 력 을 정 의 한것 이 다 . 

다시 말하여 차림 표조작을 하지 않고도 지 름건을 눌러 차림 표항목을 선택할수 있 다는 
것 이 다. 지름건이 라는 용어는 아주 적절한 표현이 다. 왜 냐하면 차림표를 능동상태로 하 
고 항목을 선택하기 보다 건을 누르는것 이 조작이 빠르기때문이다. 

차림표에 대응한 지름건을 정의하기 위해서는 자원파일에 지름건표를 추가한다. 이 
지름건표는 일반적 으로 다음과 같은 구문형식으로 서술된다. 

TableName ACCELERATORS [ accel - options ] 

{ 

Keyl , MenuIDl [ , type ] [ op 仕 ons ] 

Key 2, MenuID 2 [ , type ] [ options ] 

Key 3, MenuID 3 [ ， type ] [ options ] 


KeyN , MenuIDN |- f type ] [ options ] 


TableName 은 지 름건표의 이 름이 다. ACCELERATORS 명령문아 는 MENU 명 령 문과 
같은 추가선택을 지정 할수 있 다. 펼요하다면 그것을 accel-options 에 지정 한다. 그러나 
대 부분의 응용프로그람에 서 는 체 계 설정 을 리 용한다. 

지 름건표내부에서 Key 에는 차림표항목을 선택 하는 건을 지정 하고 MenuID 에는 대 
응하는 차림 표항목의 id 를 지정 한다. type 에는 건이 표준건 (이 설정 은 체 계 설정 이 다. ) 
인가, 가상건인가를 지정한다. 

options 에 는 NOINVERT , ALT , SHIFT , CONTROL 중의 어 느 하나를 지정 한다. 
NOINVERT 를 지 정하면 지 름건을 눌러 도 차림 표항목이 강조표시 되 지 않게 된 다. ALT 
는 [ Alt ] 건 , SHIFT 돝 [ Shift ] 건 ， CONTROL 은 [ Ctrl ] 건을 지 정 하는것 이 다. 

Key 값으로는 인용괄호(“)안에 들어 있는 문자，건의 ASCII 코드를 가리키는 옹근수 
값 또는 가상건코드를 가리 키 는 옹근수값을 지 정할수 있 다. 인용괄호안에 들어 있는 문 
자가 지정된 경우에는 이것 이 ASCII 문자인가를 판단한다. 옹근수값인 경우에는 type 에 
ASCII 를 지정하여 자원번역프로그람에 ASCII 코드를 사용한다는것을 명백하게 지정해 
주어 야 한다. 가상건인 경우에는 type 에 VIRTKEY 를 지정해 주어 야 한다. 

인용괄호안에 들어 있는 문자가 대문자인 경우에는 [ Shift ] 건과 동시에 이 건을 누 
르면 차림표항목이 선택된다. 소문자인 경우에는 이 건만을 누르는것으로서 차림표항목 
이 선택된다. 건이 소문자로 지정되고 추가선택에 ALT 가 지정된 경우에는 [ Alt ] 건과 
그 건을 동시에 누르는것으로서 차림표항목이 선택된다. (건이 대문자이고 ALT 가 지정 
된 경우에는 차림표항목을 선택하자면 [ Shift ] 건과 [ Alt ] 건을 동시에 눌러 야 한다.) 사 
용자에게 [ Ctrl ] 건과 문자를 동시 에 누르게 하려는 경우에는 건의 앞에 1 지정한다. 
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제 3 장에서 설명한바와 같이 가상건은 체계 에 존재하지 않는 건코드이 다. 지름건으 


로서 가상건을 사용하려 면 이것 을 가리키 는 
type 에 지정한다. 임의의 건조합을 실현하기 
수도 있다. 몇가지 실례를 아래에 준다. 


“ A ”, IDM—X 

// 

“ a ”, IDM_X 

// 

“ V ，, IDM_X 

// 

“ a ”, IDM — X , ALT 

// 

VK _ F 2, IDM_X 

// 

VK _ F 2, IDM _ X , SHIFT 

// 


마크로를 Key 에 지정 하고 VIRTKEY 를 
위 해 ALT , SHIFT , CONTROL 을 지 정 할 


[ SWft ] + [ A ] 을 누르면 선택된다. 
[a] 를 누르면 선택된다. 

[ Ctrl ] + [ a ] 를 누르면 선택된다. 
[ Alt ] + [ a ] 를 누르면 선택된다. 

[ F 幻를 누르면 선택된다. 

[ Shift]+[F 幻를 누르면 선택된다. 


MyMenu 에 지 름건을 추가한 자원파일 MENIJ.RC 의 내 용은 다음과 같다. 


//차림 표와 지름건의 자원파일 실례 

♦include "menu, h" 

MyMenu MENU 
{ 

POPUP “&File” 

{ 

MENUITEM “&Open\tF2”, IDM_OPEN 

MENUITEM “&Close \ tF2", IDM_CLOSE 
MENUITEM “E&xit \ tCtrl+X >, , IDM_EXIT 

} 

POPUP “&Op 吐 ons” 

{ 

MENUITEM “&Colors\tCtrl+C”, IDM_COLORS 
POPUP “SPriority"’ 

{ 

MENUITEM ll &Low\tF4 ,, > IDM_LOW 
MENUITEM “&High\tF5”, IDM_HIGH 

} 

MENUITEM “&Fonts\tCtrl+F”, IDM_FONT 
MENUITEM ^Resolution \ tCtrl+R", IDM_RESOLUTION 

} 

MENUITEM “&Help”, IDM_HELP 

} 

// 차림 표의 지름건을 정의한다. 
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{ 

VK_F2, IDM_OPEN, VTRTKEY 
VK_F3, IDM_CLOSE, VITRKEY 
“■X”， IDM_EXIT 
“*C”，IDM_COLORS 
VK_F4, IDM_LOW, VIRTKET 
VK_F5, IDMJHIGH, VIRTKEY 
“"F”, IDM_FONT 
“-R”, IDM_RESOLUTION 
VK_F1, IDMJHELP, VIRTKEY 

} 

차림표정의안에 지름건이 추가되였다는데 주목해 야 한다. 매개 차림표항목에서는 타 
브를 사용하여 지름건의 표시위치를 분리한다. WINDOWS.H 머리부파일을 포함시키는것 
은 그 안에 가상건의 마크로가 정의되여 있기때문이다. 

지름건표의 적재 

자원 파일에 차림표와 함께 지름 건을 서술 하였다면 프로 그람에서 
LoadAccelerators ( )石\는 API 함수를 사용하여 지 름건을 적재 하여 야 한다. 아래 에 이 함 
수의 선언을 보여 주었다. 


HACCEL LoadAccelerators(HINSTANCE Thislnst , LPCSTR Name ); 


Thislnst 는 응용프로그람실체의 손잡이 이 며 Name 은 지 름건표의 이 름이 다. 이 함수 
는 지름건표의 손잡이를 돌려 주며 표가 적재되지 않는 경우에는 NULL 을 돌려 준다. 

창문이 작성된 다음에 LoadAccelerators ( )를 호출해야 한다. 실례로 MyMenu 라 
는 지름건표를 넣는 방법 을 아래 에 주었다. 

HACCEL hAccel ； 

hAccel = LoadAccelerators ( hThisInst , “ MyMenu ”); 
hAccel 값은 후에 지름건을 처리할 때 러용된다. 

지름건의 변환 

LoadAccelerators () 로 지름건을 적재 하여 도 통보문순환고리 에 다른 하나의 API 함 
수를 추가하지 않고서 는 지 름건을 처 리 할수 없 다. 이 함수를 TranslateAccelerator ( M 
고 한다. 아래에 선언을 주었다. 
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int TranslateAccelerator (HWND hwnd , HACCEL hAccel , LPMSG lpMess ); 


hwnd 는 지름건을 변환하는 대상으로 되는 창문의 손잡이 이다. hAccel 은 사용하는 
지름건표의 손잡이 이 다. 이 손잡이는 LoadAccelerators ( ) 에서 돌려 받는것 이 다. 마감 
의 lpMess 는 통보문에 대 한 지시 자이 다. TranslateAccelerator () 는 지름건이 눌러 웠을 
때 TRUE 를 돌려 주며 그렇 지 않으면 FALSE 를 돌려 준다. 

TranslateAccelerator ( ) 는 지름건의 입력을 이에 대응하는 WM_COMMAND 통보 
문으로 변환하여 통보문을 창문에 보낸다. 이 통보문에서는 LOWORD ( wParam ) 에 지 
름건에 대 응하는 ID 값이 보관되 여 있다. 따라서 프로그람에서는 WM_COMMAND 통보 
문이 차림표선택에 의하여 생성되는것처럼 볼수 있다. 

TranslateAccelerator ( ) 는 지름건이 눌러울 때마다 WM_COMMAND 통보문을 발 
송하므로 이때 프로그람에서는 TranslateMessage OH DispatchMessage () 를 실행 할 필 
요는 없다. 그러므로 TranslateAccelerator ( )를 사용하는 경우의 통보문순환고리는 아 
래와 갈다. 


while (GetMeassage (&msg , NULL, 0, 0 )) 

{ 

if (! TranslateAccelerator (hwnd, hAccel, &msg)) { 


TranslateMessage(&msg); // 건반통보를 변환한다. 

DispatchMessage( &msg) ; // Windows 2000 에 조종을 넘 긴다. 



지름건의 시험 

지름건의 사용법을 시험해보기 위하여 실례 4-2 의 WinMainC ) 을 앞의 프로그람의 
것과 교체하고 자원파일에 지름건표를 추가한다. 

실례 4-2. Accel 프로그람 
// 지름건의 처 리 


#include〈windows. h> 
♦include <cstring> 
ttinclude <cstdio> 


■elude "menu, h" 
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LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM); 
char szWinName[] = "MyWin" : // 창문들라스의 이름 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 

// 창문물라스를 정의 한다. 

wcl. cbSize = sizeof (WNDCLASSEX) : 


wcl.Mnstance = hThisInst； // 실체의 손잡이 
wcl. IpszClassName = szWinName； // 창문콜라스의 이름 
wcl. lpfnWndProc = WindowFunc； // 창문함수 
wcl.style = 0; // 체계설정형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이 콘 

wcl. hlconSm = NULL； // 큰 아이론의 축소판을 사용한다. 

wcl. hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

// 차림표자원을 지정 한다. 

wcl. IpszMenuName = "My Menu" : 

wcl.cbClsExtra = 0； // 보조기 억기 령 역은 필요 없음 
wcl. cbWndExtra = 0； 

// 창문의 배경색을 흰색으로 한다. 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 


// 창문물라스를 등록한다. 

if( ! RegisterClassEx(&wcl)) return 0 ； 
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szWinName, // 창문믈라스의 이름 
"Adding Accelerator Keys", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준형식으로 한다. 
CWJJSEDEFAULT, // X 자리 표는 Windows 가 결정 하게 한다. 
CW_USEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다. 
CWJJSEDEFAULT, // 창문의 너 비는 Windows 가 결정하게 한다. 
CWJJSEDEFAULT, // 창문의 높이는 Windows 가 결정 하게 한다. 
NULL, // 어미창문은 없다. 

NULL, // 차림표는 없다. 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메터는 없 다. 

)； 


// 건반가속기를 적재 한다. 

hAccel = LoadAccelerators (hThisInst, "MyMenu") : 

// 창문을 표시 한다. 

ShowWindow (hwnd, nWinMode) ; 

UpdateWindow (hwnd ); 


// 통보문순환고리를 작성 한다. 

while(GetMessage(&msg , NULL, 0, 0)) 

{ 

if (! TranslateAccelerator (hwnd, hAccel, &msg)) { 
TranslateMessage(&msg); // 건반통보를 변환한다. 
DispatchMessage(&msg) ; // Windows 2000 에 조종을 넘 긴다. 

} 


return msg.wParam; 

} 
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I 다시 한보 전진| 


WM_COMMAND 의 상세 

지 금까지 설 명 한바와 같이 차림 표항목을 선택하거 나 지 름건을 누르면 
幻八取 통보문이 발송되 고 그때 LOWORD ( wParam ) 에는 선택된 
차림 표항목 또는 지름건의 ID 가 보관된다. 그러 나 LOWORD ( wParam ) 값만 
으로는 어떤 사건이 발생하였는가를 구별할수 없다. 일반적인 경우에는 사용 
자가 차림표항목을 선택하는가 지름건을 누르는가 하는것이 문제로 되지 않 
는다. 하지만 Windows 는 wParam 의 웃단어에 이 사건을 식별하기 위한 정 
보를 제공한다. HIWORD ( wParam ) 의 값이 0 이면 사용자가 차림표항목을 
선택한것으로 된다. 

그 값이 1 이면 사용자가 지름건을 누른것으로 된다. 

시험을 목적으로 아래의 프로그람코드를 차림 표프로그람과 치 환하시오. 
[ Open ] 이 차림 표 또는 지 름건가운데 어 느것 으로 선택 되 였는가가 통보칸에 
표시된다. 

case IDM_OPEN: 

if (HIWORD(wParam)) 

MessageBox(hwnd, ,! Open File via Accelerator”, “Open”, MB_OK”); 

else 

MessageBox(hwnd,”Open File via Menu Selection”, "Open", 
MB_OK ”); 

break； 

WM_COMMAND 통보문의 IParam 의 값은 차림표항목이 나 지름건의 선 
택에는 관계 없이 NULL 로 되므로 사용되지 않는다. 

다음 장에서 설명 하지만 WM_COMMAND 통보문은 사용자가 여 러 가지 
조종체들을 조작할 때도 생성된다. 이 경우에는 wParam , IParam 의 의미가 
여 기 에서 설명한것과 약간 다르다. 례하면 IParam 값은 조종체의 손잡이 로 
된다. 


차림표에 대응되지 않는 지름건 


건가속은 주로 차림표항목을 재빠르게 선택하기 위한 수단으로 사용되지만 그것만으 
로 그의 역할이 제한되는것은 아니다. 례를 든다면 차림표항목에 대응되지 않는 지름건 
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을 정의할수도 있다. 이러한 건은 건반마크로를 사용하는 경우나 빈번히 사용되는 추가 
선택 기 능을 선택하는것 으로 된 다. 차림 표에 대 응되 지 않는 지 름건을 정 의하려 면 간단히 
거기에 유일한 값을 붙여 지름건표에 추가하기만 하면 된다. 

실례로 차림표에 대응되지 않는 지름건을 차림표프로그람에 추가해 보자. 이 건을 
[ Ctrl ] + [ T ] 로 하여 그것 이 눌러 울 때 마다 현재 시 간과 날자를 통보칸에 표시하도록 해 
보자. C 八>+표준함수로 현재시간과 날자를 얻는다. 우선 다음과 같이 건표를 변경한다. 


실례 4-3. NonMenuAccel 프로그람 


MyMenu ACCELERATORS 
{ 

VK_F2, IDM_OPEN, VIRTKEY 
VK_F3, IDM_CLOSE, VITRKEY 
"'X", IDM_EXIT 
U 'C\ IDM_COLORS 
VK_F4, IDM_LOW, VIRTKET 

VK_F5, IDM_HIGH, VIRTKEY 
“-R”, IDM_RESOLUTION 
，F”，IDM_FONT 
VK_F1, IDM—HELP, VIRTKEY 
“■T”, IDM_TIME 


다음에 아래 한행 을 MENU . H 에 추가한다. 

#define IDM_TIME 500 

마지막으로 아래의 WindowFuncC ) 를 차림표프로그람에 있는것과 바꾸어놓는다. 
또한 프로그람코드의 첫머리에 < ctime . h > 라는 머리부파일을 포함시킨다. 


LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

int response； 
struct tm *tod; 
time_t t; 
char str [80] ； 
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switch (message) { 
case WM.COMMAND： 
switch (LOWORD (wParam)) { 
case IDM_OPEN: 

MessageBox(hwnd, "Open File' "Open", MB_OK) ； 
break； 

case IDM_CLOSE: 

MessageBoxChwnd, ” Close File”, ” Close”, MB.OK) : 
break； 

case IDM_EXIT： 

response = MessageBox(hwnd, "Quit the Program?”, 

” Exit”, MB 一 YESNO); 
if (response == ID YES) PostQuitMessage(O) ； 
break； 

case IDM_COLORS： 

MessageBox(hwnd, ’’Set Colors", ’’Colors”, MB_OK) ； 
break； 

case IDM_LOW : 

MessageBox(hwnd, "Low", "Priority", MB_OK) ； 
break； 

case IDM.HIGH： 

MessageBox(hwnd, "High", "Priority", MB_OK); 
break； 

case IDM.RESOLUTION： 

MessageBox(hwnd, "Resolution Options", 
"Resolution", MB.OK) ； 

break； 

case IDM_FONT: 

MessageBox(hwnd, "Font Options”, "Fonts”, MB_OK); 
break； 

case IDM_TIME： // 시간을 표시한다. 
t = time (NULL) ； 
tod = localtime (射:); 
strcpy (str, asctime (tod)); 
str[strlen(str)-l] = *\0’; //\r\n 을 제거한다. 
MessageBox(hwnd, str, "Time and Date", MB_OK); 
break； 
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case IDM.HELP： 

MessageBox(hwnd, "No Help", "Help，，, MB_OK); 
break； 

} 

break； 

case WM.DESTROY： // 프로그람을 완료한다. 

PostQuitMessage (0) ； 
break； 
default： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 이 처 리 하게 한다. */ 
return DefWindowProc(hwnd, message, wParam, IParam); 

} 

return 0； 

} 

이 프로그람을 실행하여 [ Ctrl ] + [ T ] 를 누르면 다음과 같은 통보칸이 표시된다. 



클라스차림표의 덧쓰기 


지 금까지 작성 한 프로그람에 서 는 기 본차림 표가 WNDCLASSEX 구조체 의 
IpszMenuName 성원으로 지정되여 있었다. 이것은 이 클라스에 기초하여 작성되는 모든 
창문에 서 사용되 는 클라스차림표를 지정하는것 이 며 간단한 프로그람의 기 본차림 표를 지 
정하는데 쓰이는 방법이다. 그러나 CreateWindow ( 사용하여 기본차림표를 지정 하 
는 방법도 쓰인다. 제 2장에서 본것처럼 CreateWindowO 는 다음과 같은 파라메터를 가 
진 다. 


HWND CreateWindow ( 

LPCSTR lpClassName, // 창문콜라스이름 
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LPVOID IpszAdditional 


LPCSTR lpWinName, 
DWORD dwStyle, 
int X, int Y, 
int Width, int Height, 
HWND hParent, 
HMENU hMenu, 
HINSTANCE hThisInst 


// 창문제 목 
// 창문형식 
// 창문의 왼쪽 웃좌표 
// 창문의 크기 
// 어미창문의 손잡이 
// 기본차림표의 손잡이 
// 실체의 손잡이 
// 보충정보지시자 


hMenu 라는 파라메 터 에 주목해 야 한다. 이 파라메 터 는 창문작성 시 에 기 본차림 표를 
지정 하는데 사용된다. 지금까지의 프로그람들에서는 이 파라메터 에 NULL 이 지정되 여 
있 었 다. hMenu 가 NULL 인 경 우에 는 클라스의 차림 표가 사용된 다. 그러 나 이 파라메 터 
에 차림표의 손잡이를 지정하면 그 차림표가 창문의 기본차림표로서 리용된다. 이런 경 
우에 는 hMenu 에서 지정된 차림 표가 클라스차림 표를 덧 쓰기 하는것 으로 된다. 

이 책 에서 소개 하는 간단한 프로그람들에서는 클라스차림 표를 덧쓰기할 필요는 없지 
만 여하튼 덧쓰기가 필요하게 되는 경우도 앞으로 있을수 있다. 례하면 일반적인 창문클 
라스를 정의해두고 그것을 특정한 용도에서만 변경하는것과 같은 때이다. 

CreateWindow ( )를 사용하여 기본차림표를 지정하려면 차림표의 손잡이 가 필요하 
다. 이것을 얻 기 위 한 가장 간단한 방법은 LoadMenu ( )石\는 API 함수를 호출하는것 이 
다. 아래에 선언을 보여 주었다. 

HMENU LoadMenu (HINSTANCE hlnst , LPCSTR lpName ) : 

hlnst 는 응용프로그람실 체 의 손잡이 이다. 차림 표이 름에 대 한 지 시 자가 lpName 에 
주어 진다. LoadMenuO 는 차림표의 손잡이를 돌려 주며 호출이 실패하면 NULL 을 돌 
려 준다. 차림 표의 손잡이 를 얻 으면 그것 을 CreateWindowC ) 의 hMenu 파라메 터 에 설 
정 한다. 

LoadMenu ( )를 사용하여 차림표를 적재한다는것은 기억기를 확보할 객체를 작성하 
는것으로 된다. 이 기억기는 프로그람이 완료되기전에 해제되여야 한다. 기억기가 창문 
에 관련되여 있는 경우 프로그람이 완료될 때 기억기의 해제가 자동적으로 진행된다. 그 
렇지 않은 경 우에 는 수동적 으로 기 억기 를 해제시켜주어 야 한다. 이 를 위해서 
DestroyMenuC ) 라는 API 함수를 사용한다. 아래 에 선언을 보여 주었 다. 

BOOL Destroy Menu (HMENU hMenu ) : 

hMenu 는 파괴 할 차림 표의 손잡이 이 다. 이 함수는 호출이 성 공하면 0 이 아닌 값을 
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돌려 주며 실패하면 0 을 돌려 준다. 이 미 설명한바와 같이 적재한 차림 표가 창문과 관 
련되 여 있다면 DestroyMenu ( )를 사용할 필요가 없다. 

클라스차림표를 덧쓰기하는 실례프로그람 

클라스차림표가 어떻게 덧쓰기되는가를 보기 위하여 지금까지 작성한 프로그람을 개 
조해 보자. 우선 아래 에 보여 주는바와 같이 MENU.RC 파일에 PlaceHolder 라는 이름 
의 두번째 차림표를 추가한다. 


// 두번째 차림표의 정의 
♦include〈windows. h> 

#include :” menu, h” 

// 를라스차림표로 되는 차림표 
PlaceHolder MENU 
{ 

POPUP “&FUe” 

{ 

MENUITEM “&Exit\tCtrl+X”，IDM_EXIT 

} 

MENUITEM “&Help，，，IDM_HELP 

} 

// CreateWindowC ) 에서 사용되는 차림 표 
MyMenu MENU 
{ 

POPUP “&File” 

{ 

MENUITEM “技 Open\l;F2’，，IDM_OPEN 
MENUITEM “&Close\tF3，，，IDM_CLOSE 
MENUITEM “E&xit\tCtrl+X”，IDM_EXIT 

} 

POPUP “&Op 仕 ons” 

{ 

MENUITEM “&Colors\tCtrl+C”, IDM_COLORS 
POPUP “SPriority" 

{ 

MENUITEM “&Low \ tF4”, IDM_LOW 
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MENUITEM “&High\tF5，，,IDM_HIGH 

} 

MENUITEM “&Font\tCtrl+F”,IDM_FONT 

MENUITEM ^Resolution \ Ctrl+R w , IDM.RESOLUTION 

} 

MENUITEM “&Help”, IDM.HELP 

} 

// 차림표의 지름건을 정의한다. 

MyMenu ACCELERATORS 

{ 

VK_F2, IDM.OPEN , VIRTKEY 

VK_F3, IDM.CLOSE, VIRTKEY 
IDM.EXIT 
，C”, IDM_COLORS 
VK_F4, IDM 一 LOW, VIRTKEY 
VK_F5, IDM.HIGH, VIRTKEY 
“ᅭ F”, 形] VLFONT 
“'R”, IDM.RESOLUTION 

VK_F1, IDM.HELP, VIRTKEY 
T，, IDM—TIME 

} 


PlaceHolder 차 림 표 는 클 라 스 차 림 표 로 서 사 용 된 다 . 다 시 말 하 면 이 것 이 
WNDCLASSEX 의 IpszMenuName 성원에 설정된다는것이다. MyMenu 는 독립적으로 
적 재 되 여 그의 손잡이 가 CreateWindow ( ) 의 hMenu 파라메 터 에 설 정 된 다. 그리 하여 
MyMenu 가 PlaceHolder 를 덧쓰기 하게 된다. 

MENU.H 의 내용은 아래와 같다. 이것은 IDM_TIME 을 추가한것을 내놓고는 앞절 
에 서 작성한것 과 같다. 


#define IDM.OPEN 
ttdefine IDM.CLOSE 
ttdefine IDM.EXIT 
#define IDM.COLORS 
Mefine IDM.LOW 
ttdefine IDM_HIGH 
#define IDM.FONT 
Mefine IDM.RESOLUTION 
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#define IDM.HELP 108 

#define IDM.TIME 500 


이 장에서 차림표프로그람에 많은 변경을 가하였으므로 클라스차림표를 덧쓰는 프로 
그람전체 를 실례 4-4 에 표시한다. 이 프로그람은 이 장에서 설명한 모든 내 용을 담고 
있 다. 


실례 4-4. Over Ride 프로그람 
// 믈라스차림 표의 덧쓰기 

^include < windows. h> 
itinclude <cstring> 
ttinclude <cstdio> 

^include <ctime> 
ttinclude ” menu, h” 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM); 
char szWinNameG = "MyWin”; // 창문클라스의 이름 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 

HMENU hMenu ； 

// 창문을 정의 한다. 

wcl.cbSize = sizeof (WNDCLASSEX) ； 


wcl.hlnstance = hThisInst； // 실체의 손잡이 
wcl. IpszClassName = szWinName； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc； // 창문함수 
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wcl.style = 0; // 체계설정형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) : // 큰 아이 콘 

wcl. hlconSm = NULL ； // 큰 아이론의 축소판을 사용한다 . 

wcl. hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

// 차림표자원을 지정한다 . 이것은 덧쓰기된다 . 
wcl. IpszMenuName = "PlaceHolder" : 

wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색은 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 


// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


// 수동으로 기본차림 표를 적재한다 . 

hMenu = LoadMenu(hThisInst , "MyMenu") ； 


II 창문을 작성 한다 . 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Adding Accelerator Keys", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 

CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 

CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결 정 하게 한다 . 

CWJJSEDEFAULT, // 창문의 너 비는 Windows 가 결정 하게 한다 . 

CWJJSEDEFAULT, // 창문의 높이는 Windows 가 결정 하게 한다 . 

NULL, // 어미창문은 없다 . 

hMenu, // 다른 기본차림표로 치환한다 . 

hThisInst, // 실체의 손잡이 

NULL // 추가파라메 터 는 없 다 . 

)； 


// 건반가속기를 적재한다 . 

hAccel = LoadAccelerators (hThisInst, "MyMenu") : 
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// 창문을 표시 한다. 

ShowWindow (hwnd, nWinMode) ； 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다. 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

if (! TranslateAccelerator (hwnd, hAccel, &msg)) { 

TranslateMessage(&msg) ； // 건반통보률 변환한다. 

DispatchMessage (技 msg) ; // Windows 2000 에 조종을 넘 긴다. 

} 

} 

return msg. wParam； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받는다. 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 

WPARAM wParam, LPARAM IParam) 

{ 

int response； 
struct tm *tod； 
time_t t; 
char str [80] ； 

switch (message) { 
case WM.COMMAND： 
switch (LOWORD (wParam)) { 
case IDM_OPEN: 

MessageBox(hwnd, "Open File' "Open”, MB_OK) ； 
break； 

case IDM_CLOSE： 

MessageBoxChwnd, "Close File”, ” Close，，, MB_OK); 
break； 

case IDM_EXIT： 
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response = MessageBox (hwnd, "Quit the Program? M , 

” Exit”, MB.YESNO) ； 
if (response == ID YES) PostQu 仕 Message (0); 
break； 

case IDM_COLORS： 

MessageBox(hwnd, "Set Colors", ” Colors”, MB_OK) ； 
break； 

case IDM_LOW : 

MessageBox(hwnd, ’’Low”, "Priority", MB_OK) ； 
break； 

case IDM.HIGH： 

MessageBox(hwnd, "High", "Priority", MB_OK) ； 
break； 

case IDM.RESOLUTION： 

MessageBox(hwnd, "Resolution Options", 
’’Resolution", MB_OK) ； 

break； 

case IDM_FONT: 

MessageBox(hwnd, "Font Options",’’Fonts”, MB 一 OK); 
break； 

case IDM_TIME： // 시간을 표시한다. 
t = time (NULL) ； 
tod = localtime (射:); 
strcpy (str, asc 切 me (tod)) ； 
str[strlen(str)-l] = ’\0’; // 을 제거한다. 
MessageBox(hwnd, str, "Time and Date", MB_OK); 
break； 

case IDM_HELP： 

MessageBox(hwnd, "No Help”, "Help，，, MB_OK); 
break； 

} 

break； 

case WM.DESTROY： // 프로그람을 완료한다. 

PostQuitMessage (0) ; 
break； 
default： 

/* 이 switch 문에서 지정되지 않은 통보문은 
Windows 2000 에 처 리를 맡긴다. */ 
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return DefWindowProc(hwnd, message, wParam, IParam); 

} 


return 0； 

} 

WinMain ( ) 함수 안의 프로그람코드에 특히 주목해야 한다. 클라스차림표로서 
PlaceHolder 를 지정한 창문클라스가 작성되고 있다. 그러나 실제로는 창문이 작성되기 
전에 MyMenu 가 적재되여 그것의 손잡이가 CreateWindow ( )를 호출하는데 리용되므 
로 클라스차림표가 덧쓰기되고 MyMenu 가 표시된다. 

이 프로그람을 사용하여 다른 실험을 해볼 필요가 있다. 실례로 클라스차림표가 덧 
쓰기된다면 처음부터 지정할 필요는 없지 않는가 하는것을 알아 보는 실험이다. 이것을 
확인해 보기 위해 lpszMenuName 의 값을 NULL 로 한다. 이렇게 해도 프로그람에는 아 
무런 영향도 가해 지지 않는다. 

이 실례 프로그람에서 는 MyMenu 와 PlaceHolder 가 다 같은 창문함수에서 처 리 할 
수 있는 차림 표로 되 여 있 다. 그러 므로 량자는 동일한 차림 표 ID 의 모임 을 사용한 
다. (그러 나 PlaceHolder 에 는 두개 의 차림 표항목밖에 없 다. ) 

이러한 기능은 앞에서 본 프로그람에서 어떠한 차림표의 사용도 가능하게 한다. 덧 
쓰기하는 차림표의 형식이나 구조에 한정되지 않는다. 그러나 어떤 차림표가 사용된다고 
해도 창문함수에서 적절한 응답을 할수 있게 하는것이 중요하다. 

CreateWindowC ) 보다 WNDCLASSEX 를 사용하는 쪽이 차림표의 작성 이 간단하 
다. 이 책의 나머지 프로그람들에서는 간단한 방법을 리용한다. 

또 하나의 중요한 요점 이 있다. 그것은 MyMenu 가 CreatWindowC ) 에 의해 작성 
된 창문과 관련되여 있으므로 프로그람을 완료할 때 차림표가 자동적으로 파괴되며 
Destroy Menu ( )를 호출할 필요는 없다는것이다. 
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대 화칸 


차림 표는 일 반적 인 Windows 2000 응용프로그람의 매 우 중요한 입 력수 
단이지만 모든 형식의 사용자입력을 처리할수 있는 만능의 수단은 아니다. 
례하면 차림표로 시간이 나 날자를 입력하는것은 불가능하다. 이 러한 형식 
의 입력을 수행하기 위하여 Windows 에서는 대화칸을 리용한다. 

대화칸이린: 사용자와 응용프로그람의 대 화를 위한 다양한 입 력 수단을 
제공하는 특수한 창문이다. 일반적으로 대화칸은 차림표로서는 실현이 어 
렵거나 불가능한 정보의 선택이나 입력을 가능하게 하는데 리용된다. 이 
장에서는 대화칸의 작성 방법과 조작법을 설명 한다. 

대화칸은 .조종乂//를 가지고 사용자와 대화한다. 어떤 의미에서 대화칸은 
여 러 가지 조종체 를 넣 어 두는 그릇이 라고 말할수 있다. 이 장에 서 는 
Windows 의 표준적 인 조종체 들가운데 서 세 가지 를 설명 한다. 

또한 대화칸과 몇가지 조종체의 사용법 을 보여 주기 위하여 간단한 자 
료기지응용프로그람을 작성한다. 이 자료기지는 수십권의 서적의 제목，저 
자명，출판사이름，저작권，날자를 보관한다. 이 장에서 작성하는 대화칸 
에서는 제목을 선택하여 그 서적에 대한 다른 정보를 얻을수 있게 되여 있 
다. 자료기지의 기능은 최소한의 단순한것 이며 실제 응용프로그람에서 대 
화칸을 효과적으로 사용하는 방법을 보여 주는데 목적을 둘뿐이 다. 
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대화칸은 조종체를 사용한다 


대 화칸은 그자체 로서 는 아무런 기 능도 수행하지 못한다. 기 술적 으로 말하면 대 화칸 
은 단순한 관리장치 이 다. 사용자와 대화하는것은 대화칸내부에 있는 조종체 이 다. 정확히 
말하면 조종체 란 입 출력 을 진행 하기 위한 특수한 창문이 다. 조종체 는 어 미 창문에 속해 
있으며 그 어미창문이 이 장에서는 대화칸으로 된다. 

Windows 2000 은 다양한 표준적조종체들을 제공하고 있다. 여기에는 누름단추 ，검 
사칸, 단일선택단추, 목록칸，편집칸， 복합칸，홀림 띠 및 정 적 조종체 등이 있 다. (다음 
장에 서 설 명 하지 만 Windows 2000 은 공통조종제과고 하는 몇 가지 고급한 조종체 도 제 공 
한다.) 

이 장의 실례 프로그람에 서 는 표준조종체 중에 서 누름단추, 목록칸, 편집 칸만을 리 용한다. 

누름단추는 사용자가 마우스를 찰칵할 때 어떤 응답을 주는 조종체 이 다. 이미 통보 
칸에서 누름단추를 사용하였다. 례하면 통보칸에서 사용한 [ OK ] 단추는 누름단추이 다. 

목록칸은 사용자가 하나 혹은 그이상의 항목을 선택할수 있는 목록을 표시하므로 례 
하면 파일이름을 표시 하는 등의 목적 에 자주 사용된다. 

편집 칸은 사용자의 문자렬 입 력 을 받아 들인다. 편집 칸은 여 러 가지 본문편집 기 능도 
제 공한다. 따라서 문자렬 을 입 력 하는 프로그람에 서 는 간단히 편집칸을 표시 해 놓고 사용 
자가 문자렬입력을 마칠 때까지 대기하도록 하면 좋다. 

조종체는 통보문을 생성하며 (사용자가 조작할 때) 한편으로는 통보문을 받는다. (응 
용프로그람으로부터 통보문을 보내온다.) 이것은 중요한 내용이다. 조종체가 생성한 통 
보문은 사용자가 진행한 조작내용을 가리키게 된다. 조종체에 보내는 통보문은 기본적으 
로는 조종체 에 대한 명령으로 된 다. 


양식화대화칸과 비양식화대화칸 


대화칸에는 양식화형과 비양식화형의 두가지 형태가 있다. 일반적으로 사용되는것은 
양식화대화칸이다. 양식화대화칸은 프로그람조작을 계속하기 위 하여 사용자의 응답을 요 
구한다. 

양식화대화칸이 능동상태로 되여 있는 때는 대화칸을 닫기전에 응용프로그람의 다른 
부분에 입력초점을 이동할수 없다. 보다 정확히 말하면 양식화대화칸의 어미창문은 대화 
칸을 닫을 때 까지 는 능동상태 로 되지 못한다. (일반적 으로 어 미 창문이 란 대 화칸을 연 창 
문이다.) 


교육성 프로그람교육멘터 


111 





Windows 2000 프로그람작성 법 


비양식화대화칸은 프로그람의 다른 부분이 리용되는것을 막지 않는다. 따라서 프로 
그람의 다른 부분에 로 초점 을 옮기 기 위 해 대 화칸을 닫을 필요가 없 다. 비양식 화대 화칸 
의 어미창문은 계속 능동상태 에 있다. 즉 비양식화대화칸은 양식화대화칸보다 독립성 이 
강하다. 

일 반적 으로 자주 사용되 는 양식 화대 화칸에 대 하여 먼저 설 명 하기 로 한다. 비양식 화 
대화칸의 실례프로그람도 이 장에서 준다. 

대화칸의 틍보문처리 


대 화칸은 창문의 일종이 다. 그 내 부에 서 발생한 사건은 기 본창문의 통보문과 같은 
방식으로 프로그람에 전송된다. 그러나 대화칸의 통보문은 프로그람에 있는 기본창문의 
창문함수에 전송되지 않는다. 대신에 매개 대화칸은 자기의 창문함수를 가지며 이 함수 
를 일 반적 으로 대화함수 혹은 대화수속이타고 한다. 이 함수는 다음과 같이 선언된 
다. (함수이름은 임의로 정의해도 상관없다.) 

BOOL CALLBACK DFunc(HWND hdwnd, UINT message, 

WPARAM wParam, LPARAM lParam); 


보는바와 같이 대화함수에는 프로그람의 기본창문의 창문함수와 꼭 같은 파라메 터가 
주어 전다. 그러나 돌림값으로서 TRUE 또는 FALSE 를 돌려 준다는것 이 기본창문의 
창문함수와 다르다. 

프로그람의 기본창문의 창문함수와 마찬가지로 대화칸의 창문함수도 수많은 통보문 
을 받는다. 통보문을 처 리 하였 다면 TRUE 를 돌려 주어 야 하며 통보문을 처 리 하지 않은 
경우에는 FALSE 를 돌려 주어 야 한다. 

대화칸안에 있는 매개 조종체에는 각각 자체의 자원 ID 가 주어 진다. 사용자가 조종 
체를 조작하면 WM_COMMAND 통보문이 대화함수에 전송되 여 사용자가 조작한 조종체 
의 ID 와 조작내용이 전달된다. 대화함수는 통보문의 내용을 참조하여 적절한 처리를 진 
행 한다. 통보문을 처 리 하는 방법 은 프로그람의 기 본창문의 창문함수와 꼭갈다. 
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대화칸들 열기 


양식화대화칸을 열려면 즉 작성 하여 표시 하기 위하여서는 DialogBox ( ) 라는 API 함 
수를 호출해야 한다. 아래에 선언을 보여 주었다. 

int DialogBox(HINSTANCE hThisInst , LPCSTR lpName , HWND hwnd , 
DLGPROC lpDFunc ) : 


hThisInst 는 프로그람의 WinMain ( ) 의 파라메 터 로서 주어 지는 응용프로그람의 실 
체의 손잡이 이다. 자원파일안에 정의되 여 있는 대 화칸의 이 름을 lpName 에 설정한다. 
대화칸의 어미창문의 손잡이를 hwnd 에 설정한다. (이것은 일반적으로 DialogBox ( )를 
호출하는 창문의 손잡이로 된다.) lpDFunc 에는 앞에서 설명한 대화함수의 지시자를 설 
정한다. 만일 DialogBox ( ) 호출이 실패하면 -1 을 돌려 준다. 그렇 지 않은 경 우에 는 
EndDialog ( ) 의 파라메 터 로서 사용되는 값을 돌려 주는데 이 에 대 해서는 다음에 설명 하 
기로 한다. 

이식과 관련한 요점 : 16 bit 의 Windows 에서는 DialogBox ( ) 의 lpDFunc 파라메 터가 
수속실체 (Procedure Instance ) 를 가리키는 지시자로 되여 있다. 수속실체란 프로그람이 
현재 사용하고 있는 자료토막을 사용하여 대화함수에 대한 련결을 진행하는 짧은 프로그 
람코드이다. 수속실체는 MakeProcInstance ( ) 라는 API 함수를 사용하여 얻는다. 그러 
나 Windows 2000 에서는 이 수법을 러용하지 않는다. lpDFunc 파라메터에는 대화함수 
그 자 체 를 설 정 한 다 . 낡 은 Winl 6 프 로 그 람코 드 를 이 식 하 는 경 우 에 는 
MakeProcInstance ( )를 호출하고 있는 부분을 삭제 하여야 한다. 


대화칸들 닫기 


양식 화대 화칸을 담으려 면 즉 화면에 서 소거 하고 파괴 하려 면 EndDialog ( ) 를 사용해 
야 한다. 아래에 선언을 보여 주었다. 

BOOL EndDialogC HWND hdwnd , int nStatus ); 
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hdwnd 는 대 화칸의 손잡이이 며 nStatus 는 DialogBox ( ) 함수가 돌려 준 상태 코드이 
다. (특별히 프로그람에서 참조하지 않는한 nStatus 의미에 대하여 의식할 필요는 없다.) 
이 함수는 호출이 성공하면 령 아닌 값을 돌려 주며 그렇지 않으면 령 을 돌려 준다. 

간단한 대화칸의 작성 


대화칸의 기본적인 개념을 익히기 위하여 간단한 대화칸을 작성하는것으로부터 시작 
해 보자. 이 대화칸에는 [Au 仕 ior ], [ Publisher ] , [ Copyright ], [ Cancel ] 의 4 개의 누 
름단추가 있다. 

[ Author ] , [ Publisher ] , [ Copyright ] 중의 하나가 눌리워 지면 이것이 선택되였다 
는것을 나타내는 대화칸을 표시한다. (후에는 누름단추를 누르면 자료기지정보를 얻게 한 
다. 이 단계에서는 통보칸만을 표시한다.) [ Cancel ] 단추가 눌러워 진 때는 화면에서 대 
화칸을 소거한다. 

대화칸의 자원파일 

대화칸의 설계도 프로그람자원과일안에 정의되여 있는 자원의 일종이다. 대화칸을 
사용하는 프로그람을 작성하려면 그것을 정의하는 자원과일이 필요하게 된다. 

차림표를 작성할 때와 같이 대화칸의 설계 를 본문편집기를 리 용하여 서술할수도 있 
지만 이 려한 방법은 그리 쓰이지 않으며 대화칸편집기를 사용하는것 이 일반적 이 다. 대화 
칸의 정의는 내부에 배치되는 여러가지 조종체들의 위치를 결정하는 등의 작업이므로 대 
화적인 도구를 사용하는 쪽이 보다 효률적 이 다. 

그러 나 이 장의 실 례프로그람의 자원파일 은 모두 본문형 식 으로 표시 되 므로 단순히 
본문으로 입력한다. 여하튼 프로그람의 대화칸을 작성할 때는 대화칸편집기를 사용하는 
것이 일반적이다. 

대다수의 실제적인 대화칸은 대화칸편집기를 사용하여 작성하므로 이 장의 실례프로 
그람에서 설명하는것은 자원파일에서의 대화칸정의의 일부분이라고 생각하면 된다 . 

대 화칸은 자원파일 에 서 DIALOG 또는 DIALOGEX 명 령 문을 리 용하여 정 의 한다. 
DIALOG 은 낡은 형식의 명 령문이지만 현재도 사용할수 있다. DIALOGEX 에는 편리한 
확장기 능들이 있 으며 다음 장에 서 도 리용한다. 현재 는 DIALOGEX 를 러용하는것 을 장 
려하고 있으므로 이 책 에서는 이 명 령 문을 리 용한다. 

이 장에 서 사용하는 DIALOGEX 명 령 문은 다음과 같다. 

Dialog-name DIALOGEX X , Y , WIDTH , HEIGHT 

Features 
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{ 

Dialog-items 

} 

Dialog-name 은 대화칸의 이름이다. 대화칸의 왼쪽웃모서리의 자리표를 X , 포 에 지 
정 하고 크기 를 WIDTH 와 HEIGHT 에 서 지 정 한다. 대 화칸에 는 많은 기능들을 지 정할수 
있다. 뒤 에서 설명하지 만 이 기능들중에는 대 화칸의 이름이 나 대 화칸형식의 지정 등이 
있 다. Dialog-items 에 서 는 대 화칸에 포함되 는 조종체 들을 지 정 한다. 

아래의 자원파일은 이 장의 첫 실례 프로그람에서 사용되는 자원의 정의 이다. 

대화칸을 여는데 사용되는 차림표, 차림표의 지름건, 차림표자체가 정의된다. 이 파 
일을 DIALOG . RC 로서 이 름을 붙인다. 

// 대화칸의 실례와 차림표자원파일 
ttinclude〈windows. h> 

#include〈dialog. h> 

MyMenu MENU 

{ 

POPUP “&Dialog” 

{ 

MENUITEM “&Dialog\tF2*，，IDM_DIALOG 
MENUITEM "E&xitXtCtrl+X", IDM_EXIT 

} 

MENUITEM “&Help，，，IDM_HELP 

} 

MyMenu ACCELERATORS 

{ 

VK_F2, IDM_DIALOG, VIRTKEY 

“■X”, IDM_EXIT 

VK_F1, IDM-HELP, VIRTKEY 

} 

MyDB DIALOGEX 10, 10, 210, 110 
CAPTION “Books Dialog Box” 

STYLE DS_MODALFRAME | WS_POPUP | WS_CAPTION | 

WS_SYSMENU 

{ 

DEFPUSHBUTTON “Author", IDD_AUTHOR, 11, 10, 36, 14 
PUSHBUTTON “Publisher”, IDD_PUBLISHER, 11, 34, 36, 14 
PUSHBUTTON “Copyright”, IDD_COPYRIGHT, 11, 58, 36, 14 
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PUSHBUTTON “Cancel”, IDCANCEL, 11, 82, 36, 16 

} 


여기에 정의되여 있는 MyDB 라는 이름의 대화칸왼쪽웃모서리의 자리표는 (10, 10) 
으로 되 여 있 다. 너 비 는 210 이 며 높이 는 110 이 다. CAPTION 系 에 놓이 는 문자렬 은 대 화 
칸의 제 목으로 된다. STKL 으 명 령 문은 작성하는 대 화칸의 형식을 지정한다. 이 장에서 
리용되는 형식을 포함하여 일반적 인 형식의 설정값을 표 5-1 에 주었다. 작성하려는 대화 
칸에 따라 적절한 형식을 OR 로 지정하여 결합할수 있다. 이 형식의 설정값은 조종체에 
서도 사용할수 있다. 


표 5-1. 일 반적 인 대 화칸의 형 식 


DS—MODALFRAME 

양식화틀거리를 가지는 대화칸 

WS—BORDER 

경계선을 가진다. 이 형태는 양식화대화칸에서 
사용할수 있다. 

WS—CAPTION 

제목띠를 가진다. 

WS—CHILD 

새끼창문으로서 작성한다. 

WS-POPUP 

튀 여 나오기 창문으로서 작성 한다. 

WS—SYSMENU 

체 계차림 표를 가진 다. 

WS—TABSTOP 

조종체는 타브정지점을 가진다. 

WS—VISIBLE 

여는것과 동시에 표시된다. 


MyDB 의 정의에서 4 개의 누름단추가 정의되였다. 첫 단추는 체계설정의 누름단추 
로 되여 있다. 이 단추는 대화칸이 처음 표시될 때 자동적으로 강조표시된다. 누름단추 
를 정의하는 일반적 인 구문은 아래 와 같다. 

PUSHBUTTON “ string ”, PBID ， X , Y , Width , Height , [, Style ] 

string 은 누름단추에 표시되는 문자렬 이 다. PBID 는 누름단추를 식 별하기 위 한 값이 
다. 단추가 눌러울 때 이 값이 프로그람에 전달된다. 단추의 왼쪽웃모서 리의 자리표는 
X , Y 로 정의되며 단추의 크기는 Width 와 Height 로 정의된다. Style 에는 누름단추의 
겉 모양을 지정한다. 만일 Style 에 아무것도 지정되 여 있지 않으면 체계설정값인 
的꿍 _ TAS 5： TC>P 가 러용되여 단추가 표시된다. 

체 계 설정 누름단추를 지 정 하는 경 우에 는 DEFPUSHBUTTON 문* 사용한다. 이 명 
령 문의 파라메 터 는 일 반적 인 단추와 갈다. 
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실례프로그람에서 사용되는 DIALOG.H 머 리부파일의 내용을 아래에 표시한다. 

ttdefine IDM_DIALOG 100 

#define IDM.EXIT 101 

Mefine IDM.HELP 102 

#define IDD_AUTHOR 200 

ttdefine IDD.PUBLISHER 201 

Mefine IDD_COPYRIGHT 202 


대화칸의 창문함수 

대화칸에서 발생한 사건은 프로그람의 기본창문함수가 아니 라 대화칸창문함수에 전 
송된다. 아래에 표시한 대화칸창문함수는 MyDB 라는 대화칸에서 발생한 사건에 응답하 
기 위한것이다. 

// 간단한 대화함수 

BOOL CALLBACK DialogFunc (HWND hdwnd, UINT message, 

WPARAM wParam, LPARAM lparam) 

{ 

switch (message) { 

case WM_COMMAND: 

EndDialog (hdwnd, 0); 
return 1； 

case IDD_COPYRIGHT: 

MessageBox(hdwnd, “Copyright”, “Copyright”, MB_OK); 
return 1； 

case IDD_AUTHOR: 

MessageBox(hdwnd, “Author”, “Author”, MB_OK) ； 
return 1； 

case IDD_PUBLISHER: 

MessageBox(hdwnd, “Publisher”, “Publisher”, MB_OK) ； 
return 1； 

} 


대 화칸안에 있는 조종체 가 조작되 면 DialogFunc(H WM_COMMAND 통보문이 전 
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송되며 이때 LOWORD ( wParam ) 에 조작된 조종체의 ID 가 보관된다. 조종체의 손잡이 
는 IParam 에 보관된 다. 

必 ia/cg 的 iflcD 에서는 대 화칸안에서 발생하는 4 개의 통보문(누름단추의 ID ) 을 처 리 
한다. 사용자가 [ Cancel ] 을 누르면 IDCANCEL 이 발송되므로 EndDialog ( ) 라는 API 
함수를 호출하여 대화칸을 닫는다. (IDCANCEL 은 WINDOWS.H 에 정의되여 있는 표준 
ID 이다.) 다른 세개의 단추를 누르면 이것들이 선택되였다는것을 표시하는 통보칸이 표 
시 된 다. 이 미 설 명한것 처 럼 이 단추들은 후에 자료기 지 의 정 보를 표시하는데 쓰인 다. 

대화 칸의 첫 실례 프로그람 


실례 5-1 에 대화칸의 실례프로그람을 주었다. 이 프로그람을 실행하면 차림표띠 에 
웃준위차림 표가 표시 된다. 차림 표에 서 [ Dialog ] 를 선택 하면 대 화칸이 표시 된다. 대 화칸 
이 표시되면 누름단추를 눌러 그 결과를 확인한다. 이미 서적자료기지가 프로그람코드에 
포함되여 있지만 아직 사용할수는 없다. 이것은 다음 실례프로그람에서 필요되는것이다. 

실 례 5-1. Dialog 프로그람 

// 양식화대화칸의 실례 
ttinclude〈windows. h> 
ttinclude <cstring> 

^include <cstdio> 
itinclude "dialog, h” 


ttdefine NUMBOOKS 7 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
BOOL CALLBACK DialogFunc(HWND, UINT, WPARAM, LPARAM) ； 

char szWinNameG = n MyWin”; // 창문들라스의 이름 

HINSTANCE hlnst； 

// 서적자료기지 
struct booksTag { 
char title [40] ； 
unsigned copyright； 
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char author [40] ； 
char publisher [40]; 

} books [NUMBOOKS] = { 

{ "C++: The Complete Reference", 1998, 

"Herbert Schildt", M Osborne/McGraw-Hill" }, 

{ "MFC Programming from the Ground Up", 1998, 

"Herbert Schildt”, M Osborne/McGraw-Hill M }, 

{ "Java： The Complete Reference", 1999, 

"Naughton and Schildt", "Osborne/McGraw-Hiir 1 }, 

{ "The C++ Programming Language", 1997, 

"Bjarne Stroustrup", "Addison-Wesley" }, 

{ "Inside OLE”, 1995, 

"Kraig Brockschmidt”, "Microsoft Press" }, 

{ "HTML Sourcebook”, 1996, 

"Ian S. Graham，、 ” John Wiley & Sons，，}, 

{ "Standard C++ Library”, 1995, 

” P. J. Plauger", "Prentice-Hall" } 

}； 

int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd； 

MSG msg； 

WNDCLASSEX wcl； 

HACCEL hAccel； 


// 창문들라스를 정의 한다. 
wcl.cbSize = sizeof (WNDCLASSEX) : 

wcl.hlnstance = hThisInst； // 실체의 손잡이 
wcl. IpszClassName = szWinName； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc； // 창문함수 
wcl.style = 0; // 체계설정형식 

wcl.hlcon = LoadIcon(NULL, IDI.APPLICATION) ； // 큰 아이콘 
wcl.hlconSm = NULL； // 큰 아이콘의 축소관을 사용한다. 
wcl.hCursor = LoadCursor(NULL, IDC.ARROW) ； // 유표의 형 식 

// 차림표자원의 이름을 지정한다. 
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wcl. IpszMenuName = "MyMenu" : 

wcl. cbClsExtra = 0； // 보조기 억 기 령 역 은 불필요함 

wcl. cbWndExtra = 0； 

// 창문의 배경색을 흰색으로 한다. 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 

// 창문클라스를 등록한다. 

if( ! RegisterClassEx(&wcl)) return 0 ； 

/* 창문콜라스를 등록하였으므로 
창문을 작성할수 있다. */ 
hwnd = CreateWindow ( 
szWinName, // 창문믈라스의 이름 
"Demonstrate Dialog Boxes", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다. 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다. 
CWJUSEDEFAULT, // Y 자리 표는 Windows 가 결 정 하게 한다. 
CW_USEDEFAULT, // 너 비는 Windows 가 결정 하게 한다. 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다. 

NULL, // 어미창문은 없다. 

NULL, //물라스차림 표의 덧쓰기는 하지 않는다. 

hThisInst, // 실체의 손잡이 

NULL // 추가파라메 터 는 없 다. 

}； 

hlnst = hThisInst; // 현재 실체의 손잡이를 보관한다. 

// 가속기를 적재한다. 

hAccel = LoadAccelerators (hThlsInst, "MyMenu") : 

// 창문을 표시 한다. 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성한다. 

while(GetMessage (&msg, NULL, 0, 0)) 

f 

if (! TranslateAccelerator (hwnd, hAccel, 技 msg)) { 
TranslateMessage(&msg) : // 건반통보를 변환한다. 
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DispatchMessage(tosg) ； // Windows 2000 에 조종을 넘 긴다. 

} 

} 

return msg. wParam； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받는다. 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

int response； 

switch (message) { 
case WM.COMMAND： 
switch (LOWORD (wParam)) { 
case IDM_DIALOG: 

DialogBox(hInst, ” MyDB”, hwnd, (DLGPROC) DialogFunc) ； 
break； 

case IDM.EXIT： 

response = MessageBox(hwnd, "Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O) ； 
break； 

case IDM_HELP: 

MessageBox(hwnd, "No Help’，, ” Help”, MB_OK); 
break； 

} 

break； 

case WM.DESTROY： // 프로그람을 끝낸다. 

PostQuitMessage (0) ； 
break； 
default： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 이 처 리 하게 한다. */ 
return DefWindowProc(hwnd, message, wParam, IParam); 


} 
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return 0； 

} 

// 간단한 대화함수 

BOOL CALLBACK DialogFunc (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

switch (message) { 
case WM.COMMAND： 
switch (LOWORD (wParam)) { 
case IDCANCEL： 

EndDialog (hdwnd, 0); 
return 1； 

case IDD_COPYRIGHT: 

MessageBox (hdwnd, " Copyright", ’’ Copyright ” , MB_OK); 
return 1； 

case IDD_AUTHOR： 

MessageBox (hdwnd, "Author", "Author", MB_OK) ； 
return 1； 

case IDD_PUBLISHER: 

MessageBox (hdwnd, ” Publisher”, "Publisher，，, MB 一 OK); 
return 1; 



return 0； 

} 

프로그람의 실행결과를 그림 5-1 에 주었다. 



그림 5-1. 대화칸프로그람의 실행결과 
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대역변수 hlnst 를 주목해야 한다. 이 변수는 WinMainC ) 에 전송되는 실체의 손잡 
이를 보관하기 위한것 이 다. 이 변수가 필요하게 되는 리유는 대화칸실체의 손잡이를 참 
조할 필요가 있기때문이다. 대화칸은 WinMainC ) 함수내에서 작성되는것이 아니라 
WindowFunc ( ) 내에서 작성된다. 그러므로 WinMain ( ) 밖에서도 참조할수 있도록 실체 
의 손잡이를 변수에 보관하는것이다. 


목특칸의 추가 


대화칸의 기능을 계속하여 알아보기 위해 앞의 프로그람에서 정의된 대화칸에 다른 
조종체를 추가해 보자. 누름단추처럼 자주 사용되는 조종체로서 목록칸이 있다. 여기서 
는 자료기지의 표제목록을 표시하고 사용자가 흥미를 가지는 항목을 선택할수 있도록 하 
기 위해 목록칸을 사용한다. LISTBOX 문와 일 반적 인 구문은 아래 와 같다. 

LISTBOX LBID W , Y . Width , Height [, Style ] 

LBID 는 목록칸을 식별하기 위한 값이 다. 목록칸의 왼쪽웃모서 리의 자러표를 X,Y 
에 지정하고 크기를 Width , Height 에 지정한다. Style 에는 목록칸의 외형을 지정한다. 
이 미 설 명 한 표준적 인 형 식 의 설정 값밖에 도 목록칸에 는 자체 의 형 식 도 있 다. 

자주 사용되는 형식을 아래에 주었다. 


LBS—NOTIFY 

항목이 두번 찰칵되였다는것을 어미창문에 알려 준다. 

LBS SORT 

목록을 분류한다. 

LBS-MULTICOLUMN 

여러개렬의 목록칸으로 한다. 

LBS.EXTENDEDSEL 

두개 이 상의 항목을 선택하는것 이 가능하다. 체 계 설정 
으로는 동시 에 한개 항목밖에 선택할수 없 다. 


Style 에 아무것도 지정 하지 않으면 체계설정 으로 LBS _ NOTIFY 와 WS_BORDERA 
선택되게 되며 목록칸이 표시된다. 

목록칸을 추가하기 위해서 DIALOG.RC 에서 대화칸의 정의를 변경한다. 우선 대화 
칸의 정의에 목록칸을 추가한다. 

LISTBOX IDD_LB1, 60, 5, 140, 33, LBS_NOTIFY | WS_BORDER | 

WS—VSCROLL | WS—TABSTOP 
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다음에 아래의 누름단추를 대화칸의 정의에 추가한다. 

PUSHBUTTON “Select Book” , IDD_SELECT, 103, 41, 54, 14 

이 러한 변경을 진행한 대화칸의 정의는 아래와 같이 된다. 

MyDB DIALOGEX 10, 10, 210, 110 
CAPTION “Books Dialog Box” 

STYLE DS_MODALFRAME | WS_POPUP | WS_CAPTION | 

WS_SYSMENU 

{ 

DEFPUSHBUTTON “Author", IDD_AUTHOR, 11, 10, 36, 14 
PUSHBUTTON “Publisher”，IDD_PUBLISHER, 11, 34, 36, 14 
PUSHBUTTON “Copyright”, IDD_COPYRIGHT, 11, 58, 36, 14 
PUSHBUTTON “Cancel”, IDCANCEL, 11, 82, 36, 16 
LISTBOX IDD_LB1, 60, 5, 140, 33, LBS_NOTIFY | WS_BORDER | 

WS_VSCROLL | WS_TABSTOP 
PUSHBUTTON “Select Book” , IDD_SELECT, 103, 41, 54, 14 
} 

DIALOG.H 에는 아래의 마크로를 추가하여 야 한다. 

#define IDD_LB1 203 

#define IDD_SELECT 204 

IDD — LB 1 는 자원 파 일 의 대 화 칸의 정 의 에 서 목록 칸을 식 별 하는 값 이 다 . 
IDD _ SELECT 는 [ Select ] 누름단추를 식별하는 값이 다. 

목록칸의 기본적인 사용법 

목록칸을 사용할 때는 두가지 처리를 해야 한다. 우선 대화칸이 처음 표시될 때 목 
록칸을 초기화해 야 한다. 이 처 리는 표시할 목록항목을 목록칸에 보내는것 으로 된다. (체 
계 설정 으로 목록칸은 비 여 있 다. ) 목록칸이 초기 화되 면 사용자가 목록을 선택한것 에 응 
답할 필요가 있다. 

목록칸은 여 러가지 통지^을 생성한다. 통지문은 조종체에서 어떠한 종류의 사건이 
발생 하였는가를 알려 주는것 이 다. (표준조종체 들은 통지 문을 생 성 한다. ) 

다음 실 례프로그람의 목록칸에 서 사용되 는 통지 문은 LBN—DBLCLK 十 이 통보문 
은 사용자가 목록칸의 항목을 두번 찰칵할 때 발송된다. 이 통보문은 목록칸이 
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WM_COMMAND 통보문을 생 성 할 때 HIWORD(wParam) 에 넣 어 진 다 . 
(LBN_DBLCLK 를 생성 하려 면 목록칸의 정의 에서 Style 에 LBS_NOTIFY 를 포함시켜 
야 한다. ) 선택 이 진행 된 경 우에 는 어 느 항목이 선택 되 였는가를 알아 보기 위하여 목록 
칸에 문의할 펼 요가 있 다. 

누름단추와 달리 목록칸은 통보문을 생 성할뿐아니 라 통보문을 받을수 있는 조종체 이 
다. 목록칸에는 몇 가지 종류의 통보문을 보낼수 있다. 목록칸(또는 기 타 조종체)에 통보 
문을 보내 기 위 하여 SendDlgItemMessage( ) 과는 API 함수를 사용한다. 아래 에 함수의 
선언을 보여 주었다. 

LONG SendDlgltemMessage ( HWND hdwnd, int ID, UINT IDMsg, 

WPARAM wParam, LPARAM lParam) : 


SendDlgltemMessage () 는 ID 에 식별자를 설정하고 IDMsg 에 설정된 통보문을대화 
칸안의 조종체 에 보낸다. 대화칸의 손잡이는 hdwnd 에 설정 한다. 통보문의 부가정보는 
wParam, lParam 에 설정한다. 이 부가정보는 통보문의 종류에 따라 다르다. 만일 조종 
체 에 보내 는 부가정 보가 없 다면 wParam 및 lParam 에 령 을 설정한다. SendDlgltem 
Message( ) 의 돌림 값은 IDMsg 의 값에 의 하여 여러가지 정보를 포함하게 된다. 

아래에 목록칸에 보낼수 있는 몇가지 통보문의 마크로를 준다. 




LB—ADDSTRING 

목록칸에 문자렬(선택항목)을 추가한다. 

LB GETCURSEL 

선택된 항목의 색인을 요구한다. 

LB SETCURSEL 

항목을 선택상태로 한다. 

LB FINDSTRING 

문자렬을 검색 한다. 

LB_SELECTSTRING 

문자렬을 검색하고 선택상태로 한 

다. 

LB_GETTEXT 

항목에 대응한 문자렬을 얻는다. 



이 통보문들의 내용을 상세히 설명해 보자. 

LB—ADDSTRING 은 목록칸에 문자렬을 추가한다. 지정된 문자렬이 목록칸의 새로운 
항목으로서 추가된다. 문자렬의 지시자를 lParam 에 설정한다.(이 통보문에서는 
wParam 이 사용되지 않는다.) 목록칸이 돌려 주는 값은 목록에 추가된 항목의 색 인으 
로 된 다. 오유가 발생한 경 우 LB_ERR 를 돌려 준다. 

LB_GETCURSEL 은 현재 선택되여 있는 항목의 색 인을 목록칸으로부터 돌려 준다. 
목록칸항목의 색 인은 령 으로부터 시 작한다. lParam 과 wParam 은 다 사용되지 않는다. 
오유가 발생 한 경 우 LB_ERR A 돌려 진다. 항목이 선택 되 여 있지 않은 경 우에 도 
LB_ERR 가 돌려 진다. 
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LB—SETCURSEL 를 사용하면 목록칸에 서 선택 상태 로 할 항목을 지 정 할수 있 다. 이 
통보문에서는 wParam 에 선택상태로 할 항목의 색 인을 지정한다. IParam 은 사용되지 
않는다. 오유가 발생 한 경우에는 LB—ERRA 돌려 진다. 

LB_FINDSTRING 4 r 사용하면 목록중의 항목을 검 색 할수 있 다. LB_FINDSTRING 
은 지 정 한 문자렬과 부분적 으로 일 치 하는 목록항목을 검 색 한다. wParam 에 는 검 색 을 개 
시할 항목의 색인을 설정하고 IParam 에는 검색하려는 문자렬의 지시자를 설정한다. 일 
치하는 항목을 찾으면 그것의 색인을 돌려 준다. 그렇지 않은 경우에는 LB_ERRA 돌려 
진다. 또한 LB_FINDSTRING 은 목록칸의 항목을 선택 상태 로 하지 않는다. 

검색된 항목을 선택상태로 하려는 경우에는 LB_SELECTSTRING 을 사용한다. 파 
라메 터 는 LB_FINDSTRING 와 같지 만 일 치 하는 항목을 선택 상태 로 한다. 

LB_GETTEXT 를 사용하면 목록칸의 항목의 문자렬 을 얻 을수 있 다. 이 경 우에 는 
wParam 에 항목의 색 인을 설정하고 IParam 에는 얻는 NULL 로 종결되는 문자렬을 보관 
하기 위한 문자렬지시 자를 설정한다. 호출이 성공하면 문자렬의 길이를 돌려 주며 실패 
하면 LB_ERR 가 돌려 진다. 

목록칸의 초기화 

이미 설명한바와 같이 작성된 직후의 목록칸은 비여 있는 상태이다. 이것은 목록칸 
이 표시될 때마다 목록칸을 초기화해 야 한다는것 을 의미한다. 이 처 리는 그리 어 렵지 않 
다. 대화칸이 작성될 때마다 WMJNITDIALOG 통보문이 보내지도록 되여 있으므로 
DialogFunc ( ) 의 switch 문아래에 case 를 추가하면 목록칸을 초기화할수 있다. 

case WMJNITDIALOG： //목륵칸을 초기화한다. 

for(i=0； KNUMBOOKS； i++) 

SendDlgltemMessage (hdwnd, IDD_LB1, 

LB_ADDSTRING, 0, (LPARAM)books [i]. Title) : 

// 초기항목을 선택상태로 한다. 

SnedDlgltemMessage (hdwnd, IDD_LB1, LB_SETCURSEL, 0, 0); 


return 1； 


이 프로그람코드는 배렬 books 에 정의된 서적제목들을 목록칸에 넣는다. 매개 문자 
렬은 LB_ADDSTRING 통보문을 지정한 SnedDlgltemMessage ( ) 를 반복호출하여 목록 
칸에 추가된다. 추가하는 문자렬의 지시 자는 IParam 에 설정 한다. (이때 지시 자를 부호 
없는 옹근수로 하기 위하여 LPARAM 에로의 형변환이 필요하게 된다.) 이 실례프로그 
람에서 는 매 개 문자렬 이 보내 여 지 는 순서 로 목록칸에 추가된다. (그러 나 만일 목록칸의 
Style 에 LBS_SORT 가 포함되여 있다면 항목이 영문자모순서로 분류된다.) 목록칸에 
보낸 항목의 수가 창문에 표시할수 있는 범위보다 큰 경우에는 자동적으로 수직홀림띠가 
추가된다. 
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이 프로그람코드에서는 목록칸의 첫 항목을 선택상태 로 하기 위한 처 리도 진행한다. 
목록칸이 작성된 직후에는 아무 항목도 선택되지 않은 상태로 되여 있다. 이러한 상태 
로 해둘 필요가 있는 경 우도 있지 만 여 기 에서 는 그렇게 하지 않는다. 사용자의 리용상 
편리를 고려하여 목록칸의 첫 항목이 선택된 상태 로 초기 화하여 놓는것 이 일반적 이 다. 


참고 : WMJNITDIALOG 는 목록칸이 열려질 때마다 발송된다. 이 통보문을 받을 때 
대화칸에서 펼요되는 모든 초기화처러를 진행하여야 한다. 


선택의 처리 

목록칸이 초기화되면 그것을 사용할수 있는 준비가 된것으로 된다. 사용자가 목록칸 
을 선택하는 방법 에 는 두가지 가 있 다. 

첫번째 방법은 목록칸의 항목을 두번 찰칵하는것이다. 이렇게 하면 WM _ 
COMMAND 통보문이 대화칸의 창문함수에 돌려 진다. 이 경우에는 LOWORD 
( wParam ) 에 목록칸의 ID 가 보관되며 HIWORD ( wParam ) 에 LB_DBLCLK 라는 통지문 
이 넣어 진다. 두번 찰칵에 의하여 프로그람은 사용자의 선택을 즉시 알수 있다. 

두번째 방법은 목록칸을 선택항목을 반전표시시키기 위해서만 사용하는것이다. (한 
번 찰칵 또는 방향건을 사용하여 반전표시할 항목을 이 동할수 있 다. ) 목록칸은 항목이 
선택된 상태 를 보관하고 프로그람으로부터 의 요구를 기 다린 다. 실례 프로그람에서는 두가 
지 방법을 다 리용하였다. 목록칸의 항목이 선택되 였다면 목록칸에 LB_GETCURSEL 통 
보문을 보내여 어느 항목이 선택되였는가를 알수 있다. 목록칸은 선택된 항목의 색인을 
돌려 준다. 항목이 선택되기전에 이 통보문을 보내면 목록칸은 LB_ERR 를 돌려 준다. 이 
로부터 목록칸이 초기화될 때 어떤 항목을 선택상태 로 해놓는것 이 좋다는것을 알수 있다. 

목록칸의 선택 을 처 리 하기 위 하여 DialogFunc ( ) 의 switch 문 아래 에 case 를 추가 
한다. 긴 옹근수 i 및 문자렬 str 를 DialogFunc ( ) 에서 선언해 야 한다. 현재 대화칸은 
그림 5-2 에 서 보여 준것 과 같다. 두번 찰칵 또는 [Select Book ] 누름단추가 눌러 울 때 마 
다 항목이 선택되며 선택된 서적에 대한 정보가 통보칸에 표시된다. 
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case IDD.LBl ： II 목록칸의 LBN_DBLCLK 를 처 리 한다 . 

// 사용자가 선택을 진행하였는가를 확인한다 . 
if (HIWORD (wParam) ==LBN_DBLCLK) { 

i = SendDlgltemMessage (hdwnd, IDD_LB1, 

LB.GETCURSEL, 0, 0); // 색 인을 얻 는다 . 
sprintf(str, "%s\n%s\n%s, %u”, 

books [i]. title, books [i]. author, 
books [i]. publisher, books [i]. copyright); 

MessageBox(hdwnd, str, "Selection Made”, MB_OK) ； 

// 색인에 대응한 문자렬을 얻는다 . 

SendDlgltemMessage (hdwnd, IDD_LB1, LB_GETTEXT, 
i, (LPARAM) str )； 

} 

return 1 ； 

case IDD.SELECT ： // [Select Book] 단추가 눌러웠다 . 
i = SendDlgltemMessage (hdwnd, IDD_LB1, 

LB.GETCURSEL, 0, 0); // 색 인을 엄는다 . 
sprintf(str, "%s\n%s\n%s, %u”, 

books [i]. title, books [i]. author, 
books [i]. publisher, books [i]. copyright); 

MessageBox(hdwnd, str, ” Selection Made”, MB_OK) ； 

// 색인에 대응한 문자렬을 얻는다 . 

SendDlgltemMessage (hdwnd, IDD.LBl, LB_GETTEXT, 
i, (LPARAM) str); 

return 1; 

IDD.LBl 의 case 문의 프로그람코드를 주목해 야 한다. 목록칸은 여 러 종류의 통지 
문을 생성하므로 사용자가 항목을 두번 찰칵하였다는것을 식별하려면 wParam 의 웃단어 
를 확인해 야 한다. 이것은 조종체가 통지문을 생성하여도 그것 이 두번 찰칵통보문이라고 
단정 하지 않는다는것 이 다. (흥미 가 있다면 목록칸의 다른 통지 문들도 조사해 볼수 있 다. ) 
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편집칸의 추가 


여 기 에서는 대 화칸에 편집칸을 추가한다. 편집^■은 사용자가 임의의 문자렬을 입 력할 
때 편리 하다. 실례 프로그람에서는 사용자가 편집칸에서 서적의 제목을 입 력하도록 한다. 

제목과 일치하는 항목이 목록에 있다면 그것이 선택되고 서적에 대한 정보가 표시된 
다. 편집칸을 추가하여 간단한 자료기지응용프로그람의 기능을 확장할수 있지만 여기에 
는 다른 목적도 있다. 그것은 두개의 조종체를 호상 련관속에서 동작시키는 방법을 배우 
는것 이 다. 

편집칸을 사용하기 에 앞서 자원파일에 그의 정의를 추가해 야 한다. 여 기서는 
MyDB 를 아래 와 같이 변경 한다. 

MyDB DIALOGEX 10, 10, 210, 110 
CAPTION “Books Dialog Box” 

STYLE DS_MODALFRAME | WS_POPUP | WS_CAPTION | 

WS_SYSMENU 

{ 

DEFPUSHBUTTON “Author", IDD_AUTHOR, 11, 10, 36, 14 
PUSHBUTTON “Publisher”, IDD_PUBLISHER, 11, 34, 36, 14 
PUSHBUTTON “Copyright”, IDD_COPYRIGHT, 11, 58, 36, 14 
PUSHBUTTON “Cancel”, IDCANCEL, 11, 82, 36, 16 
LISTBOX IDD_LB1, 60, 5, 140, 33, LBS_NOTIFY | WS_BORDER | 

WS_VSCROLL | WS_TABSTOP 
PUSHBUTTON “Select Book” , IDD_SELECT, 103, 41, 54, 14 
EDITTEXT IDD_EB1, 65, 73, 130, 12, ESJLEFT | 

WS_BORDER | ES_AUTHORSCROLL | WS_TABSTOP 
PUSHBUTTON “Title Search”, IDD_DONE, 107, 91, 46, 14 
} 

사용자가 편집칸에서 서 적의 제 목을 입 력하였 다는것 을 프로그람에 알려 주기 위해 
[Title Search ] 라는 누름단추를 추가하였 다. 추가된 편집 칸의 ID 는 IDD _ EB 1 이 다. 이 
정의 에서는 표준적 인 편집칸이 작성된다. 

EDITTEXT 를와 일반적인 구문을 아래에 주었다. 

EDITTEXT EDID , X , Y , Width , Height , [, Style ] 


EDID 는 편집칸을 식 별 하는 값이 다. 편집칸의 왼쪽웃모서 리 의 자리 표는 X , 모 에 지 
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정 하고 크기는 Width , Height 에 지정 한다. Style 에는 편집칸의 형식을 지정한다. 표 
5-1 에 준 형식설정값밖에 EDITTEXT 는 다른 형식들도 제공한다. 그중에서 가장 중요 
한것은 표幻묘 SC 次幻 LL 일것 이 다. 이 형식 에서는 편집 칸의 본문이 좌우로 자동적 으 
로 이동된다. 

다음 DIALOG.H 의 정의에 아래의 마크로를 추가한다. 

#define IDD_EB1 205 

#define IDD_DONE 206 

편집칸은 많은 통보문을 받으며 또한 여 러 가지 통보문들을 생 성한다. 그러 나 이 실 
례프로그람의 목적 에 따르면 프로그람에 서 응답해 야 하는 통보문은 없 다. 편집칸은 내 부 
적으로 편집기능을 갖추고 있으며 프로그람에서 처 리할 필요는 없다. 프로그람에서 처 리 
해 야 하는것 은 편집칸의 현재 내 용을 엄 는 시 간을 결정하는것 뿐이 다. 

편집 칸의 현재 내 용을 얻 으러 면 GetDlgItemText () 라는 API 함수를 사용해 야 한다. 
아래에 선언을 보여 주었다. 

UINT GetDlgltemText (HWND hdwnd , int nID , LPSTR lpstr , int nMax ); 

이 함수는 편집칸의 내 용을 lpstr 이 가리 키 는 문자렬 에 복사한다. 대 화칸의 손잡이 
는 hdwnd 에 설정한다. 편집칸의 ID 는 nID 에 지정한다. 문자렬을 복사하는 최대길이 
는 nMax 에 지정한다. 이 함수는 실제로 얻은 문자렬의 길이를 돌려 준다. 

모든 응용프로그람에 서 필 요되 는것 은 아니 지 만 SetDlgItemText ( ) 과는 함수를 사용 
하여 편집칸의 내 용을 초기 화할수 있다. 아래 에 선언을 보여 주었 다. 

BOOL SetDlgltemText(HWND hdwnd , int nID , LPSTR lpstr ); 

이 함수는 lpstr 가 가리 키는 문자렬을 편집칸의 내 용으로 보관한다. 대 화칸의 손잡 
이는 hdwnd 에 지정 한다. 편집 칸의 ID 는 nID 에 지정 한다. 함수호출이 성공하면 령 이 
아닌 값을 돌려 주며 실패하면 령을 돌려 준다. 

실 례 프로그람에 편집 칸을 추가하려 면 아래 의 case 문을 DialogFuncC ) 의 switch 문 
에 추가한다. [Ti 吐 e Search ] 단추가 눌러울 때마다 편집 칸의 현재 문자렬과 일치 하는 제 
목이 목록칸의 항목으로부터 검 색된다. 검색 이 일치한 경우에는 그 제목이 목록칸에서 
선택된다. 

제목은 앞의 몇문자를 입 력하여도 관계 없다. 목록칸은 부분적 인 문자렬과 일치하는 
제목의 검색을 자동적으로 진행한다. 

case IDD_DONE ： // [Title Search] 단추가 늘리웠다 . 

// 편집칸의 현재 내 용을 엄 는다 . 
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GetDlgltemText (hdwnd, IDD_EB1, str, 80); 

// 목록칸에서 일치하는 문자렬을 검색 한다 . 

i = SendDlgltemMessage (hdwnd, IDD_LB1, LB_FINDSTRING, 

0, (LPARAM) str )； 

if(i != LB_ERR) { // 검색이 일치한 경우 
// 일치한 제목을 목록칸에서 선택한다 . 

SendDlgltemMessage(hdwnd, IDD_LB1, LB_SETCURSEL, i, 0) ； 
// 색인에 대웅한 문자렬을 엄는다 . 

SendDlgltemMessage (hdwnd, IDD_LB1, LB_GETTEXT, 
i, (LPARAM) str )； 

// 색 인의 문자렬을 갱신한다 . 

SetDlgltemText (hdwnd, IDD_EB1, str) : 

} 

else 

MessageBox(hdwnd, str, "No Title Matching", MB_OK); 
return 1 ； 


이 프로그람코드에 서 는 편집칸의 현재내 용을 얻 고 그것 과 일 치하는 문자렬 을 편집칸 
에서 검색한다. 검색이 일치하였다면 목록칸의 항목을 선택하고 목록칸의 문자렬을 편집 
칸에 복사한다. 이렇게 두개의 조종체가 호상 련관속에서 동작하게 된다. 

INITDIALOG 의 case 문에는 다음의 프로그람코드도 추가해 야 한다. 이것은 대 화칸 
이 표시 될 때 마다 편집칸을 초기 화하기 위한것 이 다. 

// 편집 칸을 초기화한다 . 

SetDlgltemText (hdwnd, IDD_EB1, books [0]. title) ; 

이 러한 변경들외 에도 목록칸의 처 리를 진행하는 프로그람코드도 선택된 서적의 제목 
을 자동적으로 편집칸에 복사하도록 개조하여야 한다. 이려한 개조는 다음에 보여 주는 
완성된 프로그람에 반영되게 된다. 

양식화대화칸의 완성된 프로그람 

누름단추, 목록칸, 편집칸이 있는 양식 화대 화칸의 완성 된 실 례프로그람을 실 례 5-2 
에 주었다. 누름단추의 처 리를 진행하는 프로그람코드는 목록칸에 현재 선택되 여 있는 
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제목과 관련한 정보를 표시하도록 되여 있다. 그림 5-3 에는 이 프로그람의 실행결과를 
주었다. 


실 례 5-2. ModalDialog 프로그람 

// 양식화대화칸의 완전한 프로그람코드 
#include 〈 windows. h> 
ttinclude <cstring> 
itinclude <cstdio> 

^include "dialog, h" 


ttdefine NUMBOOKS 7 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM); 
BOOL CALLBACK DialogFunc(HWND, UINT, WPARAM, LPARAM) ； 

char szWinName[] = M MyWin n ； // 창문클라스의 이름 


HINSTANCE hlnst ； 


// 서적자료기지 
struct booksTag { 
char title [40]; 
unsigned copyright ； 
char author [40] ； 
char publisher [40] ； 

} books [NUMBOOKS] = { 

{ ’’C++: The Complete Reference", 1998, 

"Herbert Schildt”, "Osborne/McGraw-Hill" }, 

{ ” MFC Programming from the Ground Up", 1998, 
"Herbert Schildt", "Osborne/McGraw-Hill" }, 

{ "Java ： The Complete Reference", 1999, 

” Naughton and Schildt", M Osborne/McGraw-Hill n }, 
{ ’’The C++ Programming Language”, 1997, 

” Bjarne Stroustrup", "Addison-Wesley” }, 

{ "Inside OLE”, 1995, 

"Kraig Brockschmidt", "Microsoft Press" }, 

{ "HTML Sourcebook”, 1996, 
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M Ian S. Graham", ” John Wiley & Sons” }, 
{ "Standard C++ Library”, 1995, 

”P. J. Plauger", ” Prentice-Hall" } 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg; 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 


// 창문클라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) : 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ； // 큰 아이콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC.ARROW) ； // 유표의 형 식 

// 차림표자원의 이름을 지정한다 . 
wcl. IpszMenuName = "MyMenu" ； 

wcl.cbClsExtra = 0 ； // 보조기억기령역은 불필요함 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색은 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ； 

// 창문클라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문들라스가 등록되였으므로 
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창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Demonstrate Dialog Boxes", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결 정 하게 한다 . 
CW_USEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, //를라스차림 표의 덧쓰기는 하지 않는다 . 

hThisInst, // 실체의 손잡이 

NULL // 추가파라메 터 는 없 다 . 

>； 


hlnst = hThisInst ； // 현재 실체의 손잡이를 보관한다 . 

// 가속기를 적재한다 . 

hAccel = LoadAccelerators (hThisInst, "MyMenu") : 

// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while(GetMessage(&msg , NULL, 0, 0)) 

{ 

if(! TranslateAccelerator(hwnd, hAccel, 技 msg)) { 
TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage(Smsg) ; // Windows 2000 에 조종을 넘 긴다 . 

} 

} 

return msg. wParam ； 

} 


/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받는다 . 
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*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

int response; 


switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM—DIALOG: 

DialogBox(hInst, ” MyDB”, hwnd, (DLGPROC) DialogFunc) ； 
break ； 

case IDM.EXIT ： 

response = MessageBox(hwnd, "Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O); 
break ； 

case IDM_HELP: 

MessageBox(hwnd, "No Help”, "Help”, MB 一 OK); 
break ； 

} 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

A 이 switch 문에서 지정되지 않은 통보문은 
Windows 2000 에 처 리 률 맡긴 다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam); 


return 0 ； 

} 

// 간단한 대화함수 

BOOL CALLBACK DialogFunc (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 


{ 
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long i; 

char str [255] ； 


switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDCANCEL ： 

EndDialog (hdwnd, 0); 
return 1 ； 

case IDD 一 COPYRIGHT: 
i = SendDlgltemMessage (hdwnd, IDD_LB1, 

LB.GETCURSEL, 0, 0) ; // 색 인을 엄는다 . 
sprintf (str, "%u" , books [i]. copyright) ； 

MessageBox(hdwnd, str, "Copyright", MB_OK) ； 
return 1; 

case IDD.AUTHOR ： 

i = SendDlgltemMessage (hdwnd, IDD_LB1, 

LB_GETCURSEL, 0, 0); // 색 인을 엄는다 . 
sprintf (str, "%s", books [i]. author); 

MessageBox(hdwnd, str, "Author", MB_OK) ； 
return 1; 

case IDD.PUBLISHER ： 
i = SendDlgltemMessage (hdwnd, IDD_LB1, 

LB_GETCURSEL, 0, 0); // 색 인을 엄는다 . 
sprintf (str, "%s", books [i]. publisher); 

MessageBox(hdwnd, str, "Publisher”, MB_OK) ； 
return 1; 

case IDD.DONE: // [Title Search] 단추가 눌러웠다 . 

// 편집 칸의 현재 내용을 엄는다 . 

GetDlgltemText (hdwnd, IDD_EB1, str, 80); 

// 목록칸의 문자렬을 검색한다 . 

i = SendDlgltemMessage(hdwnd, IDD.LBl, LB_FINDSTRING, 
0, (LPARAM) str )； 


if(i != LB_ERR) { // 검색이 일치한 경우 
// 목록칸의 항목을 선택 한다 . 

SendDlgltemMessage (hdwnd, IDD_LB1, LB_SETCURSEL, i, 0) ； 
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// 색인에 대응한 문자렬을 얻는다 . 

SendDlgltemMessage (hdwnd, IDD_LB1, LB_GETTEXT, 
i, (LPARAM) str )； 

// 편집칸의 문자렬을 갱신한다 . 

SetDlgltemText(hdwnd, IDD_EB1, str )； 

} 

else 

MessageBox(hdwnd, str, "No Title Matching", MB_OK); 
return 1 ； 

case IDD_LB1 ： // 목록칸의 LBN_DBLCLK 을 처리한다 . 

// 사용자가 선택을 진행하였는가를 확인한다 . 
if (HIWORD (wParam) ==LBN_DBLCLK) { 
i = SendDlgltemMessage (hdwnd, IDD_LB1, 

LB_GETCURSEL, 0, 0 )； // 색 인을 얻는다 . 
sprin 社 (str, "%s \ n%s \ n%s, %u", 

books ■: . title, books [i]. author, 
books [i]. publisher, books [i]. copyright) : 

MessageBox(hdwnd, str, "Selection Made", MB_OK); 

// 색인에 대응한 문자렬을 얻는다 . 

SendDlgltemMessage (hdwnd, IDD_LB1, LB_GETTEXT, 
i, (LPARAM) str )； 

// 편집칸을 갱신한다 . 

SetDlgltemText(hdwnd, IDD_EB1, str )； 

} 

return 1 ； 

case IDD_SELECT: //■ fSelect Book] 단추가 눌러웠다 . 
i = SendDlgltemMessage (hdwnd, IDD_LB1, 

LB_GETCURSEL, 0, 0); // 색 인을 얻 는다 . 
sprintf (str, "%s \ n%s \ n%s, %u", 

books [i]. title, books [i]. author, 
books [i]. publisher, books [i]. copyright) : 

MessageBox(hdwnd, str, "Selection Made", MB_OK); 

// 색 인에 대웅한 문자렬을 엄는다 . 

SendDlgltemMessage (hdwnd, IDD_LB1, LB_GETTEXT, 
i, (LPARAM) str )； 
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// 편집 칸을 갱 신한다 . 

SetDlgltemText (hdwnd, IDD_EB1, str); 
return 1 ； 

break ； 

case WMJNITDIALOG ： // 목록칸을 초기화한다 . 
for(i=0 ； KNUMBOOKS ； i++) 

SendDlgltemMessage (hdwnd, IDD_LB1, 

LB_ADDSTRING, 0, (LPARAM) books [i]. 社仕 e); 

// 첫 항목을 선택상래로 한다 . 

SendDlgltemMessage (hdwnd, IDD_LB1, LB_SETCURSEL, 0, 0) ； 
// 편집 칸을 초기화한다 . 

SetDlgltemText (hdwnd , IDD_EB1, books [0]. title) : 
return 1 ； 

} 

return 0 ； 

} 

이 프로그람의 실행 결과를 그림 5-3 에 주었다 . 



그림 5-3. 양식화대화칸의 완성된 프로그람실행 결과 
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비양식화대화칸의 사용법 


이 장을 끝내기에 앞서 지금까지 프로그람에서 사용한 양식화대화칸을 비양식화대화 
간으로 개 조해 보자. 비양식 화대 화칸을 리용하자면 약간한 추가작업 이 필 요하게 된 다. 
그의 주되는 리유는 비 양식화대화칸이 양식화대화칸에 비 하여 보다 독립성 이 높기때문이 다. 
비 양식화대화칸이 표시될 때도 프로그람의 다른 부분은 능동인 상태 그대로 있다. 비 양식화 
대화칸의 창문함수와 응용프로그람의 창문함수는 둘 다 통보문을 받아 들인다. 그러므로 비 
양식 화대 화칸을 리용하려 면 응용프로그람의 통보문순환고리에 도 기 능을 추가하여 야 한다. 
비 양식화대 화칸을 작성 하는데는 DialogBox ( )를 리 용할수 없다. 대 신에 CreateDialogC ) 
라는 API 함수를 사용하여 야 한다. 아래 에 이 함수의 선언을 보여 주었 다. 


HWND CreateDialog (HINSTANCE hThisInst , LPCSTR lpName , 

HWND hwnd , DLGPROC lpDFunc ) : 

hThisInst 는 프로그람의 WinMain ( ) 의 파라메터 로서 주어 진 실체의 손잡이 이다. 
자원파일에서 정의된 대화칸의 이름을 lpName 에 설정한다. 대화칸의 어미 창문의 손잡 
이를 hwnd 에 설정 한다. (이것은 일 반적 으로 CreateDialogC )를 호출하는 창문의 손잡 
이 이 다. ) 

lpDFimc ( M 는 대 화함수의 손잡이 를 설 정 한다. 이 대 화함수는 양식 화대 화칸에 서 
리용되던것과 동일한 형식으로 되여 있다. CreateDialogC ) 는 대화칸의 손잡이를 돌려 
준다. 대 화칸을 작성할수 없는 경 우에 는 NULL 을 돌려 준다. 

양식 화대 화칸과 달리 비양식 화대 화칸은 자동적 으로 표시 되 지 않는다. 비양식 화대 화 
칸을 작성한후에 ShowWindowC ) 함수를 호출하여 표시하여 야 한다. 그러나 자원파일 
의 대 화칸정의 에 WS_VISIBLE 을 추가하면 자동적으로 표시된다. 비 양식화대 화칸을 닫 
자면 EndDialogC ) 가 아니라 Destroy Window ( ;함수를 호출하여야 한다. 아래에 이 함 
수의 선언을 주었다. 


BOOL Destroy Window (HWND hwnd ); 


hwnd 는 닫으려는 창문(이 경우에는 대화칸)의 손잡이 이다. 이 함수의 돌림값은 호 
출이 성공하면 령 이 아닌 값이며 실패 하면 령이 다. 

응용프로그람의 창문함수는 비 양식화대화칸이 능동인 상태 라고 해도 통보문을 계속 
받아 들이 고 있으므로 프로그람의 통보문순환고리 에 IsDialogMessageC ) 할今의 호출을 
추가하여 야 한다. 이 함수는 대 화칸의 통보문을 비양식 화대 화칸에 보낸다. 아래 에 선언 
을 보여 주었다. 
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BOOL IsDialogMessage (HWND hdwnd , LPMSG msg ) : 


hdwnd 는 비 양식 화대 화칸의 손잡이 이 며 msg 는 프로그람의 통보문순환고리 의 
GetMessageC ) 함수에서 받아 들이는 통보문이다. 이 함수의 돌림값은 통보문이 대화칸 
에 전송되는것 이라면 TRUE 로 된다. 그렇지 않은 경우에는 FALSE 로 된다. 통보문이 
대화칸에 보내는것인 경우에는 그것이 대화칸의 창문함수에 자동적으로 전달된다. 그리 
하여 hDlg 를 대화칸의 손잡이로 하여 대화칸의 통보문을 처 리한다면 프로그람의 통보문 
순환고리는 아래와 같이 된다. 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

if (! hDlg 11 ! IsDialogMessage (hDlg, &msg)) { 

// 대화칸의 통보문이 아닌 경우 

if ( ! TranslateAccelerator (hwnd, hAccel, &msg)) { 

TranslateMessage(&msg) ； // 건반통보를 변환한다 . 

DispatchMessage(tosg) ; // Windows 2000 에 조종을 넘 긴 다 . 



이것을 보면 알수 있는바와 같이 hDlg 가 NULL 이거나 통보문이 대화칸에 보내는 
것이 아닌 경우에만 통보문순환고리의 나머지 부분의 처리가 진행된다. hDlg 의 값을 검 
사하여 IsDialogMessage ( ) 가 무효한 손잡이를 호출하는것을 방지 할수 있 다. 


|다시 한보 전진| 


조종체를 무효로 하기 

조종체를 임의의 상황에서 항시 사용가능하게는 하지 말아야 할 경우도 있다. 
만일 필요하다면 조종체를 무효로 할수 있다. 조종체를 유효 혹은 무효로 하려면 
EnableWindow( API 함수를 사용한다. 아래 에 그 선언을 보여 주었 다. 

BOOL EnableWindow(HWND hCntl , BOOL How )； 

hCntl 은 대 상으로 되 는 창문의 손잡이 이 다. (조종체 도 창문의 일종이 다.) 
How 가 령 이 아닌 경우에 는 조종체 가 유효로 되 고 사용가능하게 된다. How 가 
령 인 경우에는 조종체 가 무효로 된다. 조종체가 이미 무효로 되 여 있던 경우에 
함수의 돌림값은 령 이 아닌 값이고 조종체가 직전까지 유효로 되여 있던 경우에 
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함수의 돌림값은 령으로 된다. 조종체의 손잡이를 받기 위하여 GetDlgltemO 이 
라는 API 함수를 쓴다. 아래 에 선언을 보여 주었 다. 

HWND GetDlgltemCHWND, inr ID )； 

hDwnd 는 조종체가 속한 대화칸의 손잡이 이다. 조종체의 식별자를 ID 에 설 
정한다. 이 값은 자원파일에서 조종체 에 지정 한것 이 다. 함수의 돌림 값은 지정된 
조종체 의 손잡이 로 되 며 호출이 실패한 경 우에 는 NULL 로 된다. 

이 함수들을 사용하여 조종체를 무효로 하는 방법을 보여 주는 실례를 보자. 
아래의 프로그람코드는 [Au 比 ior] 누름단추를 무효로 하는것이다. 여기서 hwpb 
는 HWND 형의 변수이 다. 

hwpb = GetDlgltemC hdwnd , IDD _ AUTHOR ); // 단추의 손잡이를 얻는다 . 
EnableWindows ( hwpb , 0); //단추를 무효로 한다 . 

이 장과 다음 장의 실 례프로그람에 서 사용되 는 다른 조종체 들을 무효나 유효 
로 하는것은 독자들에게 맡긴다. 


비양식화대화칸의 작성 

지 금까지 작성한 실 례프로그람의 양식 화대 화칸을 비양식 화대 화칸으로 개 조하는데 필 
요한 변경개 소는 놀랄만큼 적 다. 

우선 DIALOG.RC 자원파일 에서 대 화칸의 정의 를 변경한다. 비양식 화대 화칸은 자 
동적으로 표시되지 않으므로 대화 칸의 정의에 WS_VISIBLE 을 추가 한다. 
DS — MODALFRAME 4： 삭제하고 이것을 WS_BORDER 로 바꾸어놓는다. 이런 변경을 진 
행한 DIALOG. RC 의 내 용은 다음과 같다. 

//대화칸의 실례와 차림표의 자원파일 
# include 〈 windows . h > 

♦ include 〈 dialog . h > 

MyMenu MENU 
{ 

POPUP “& Dialog ” 

{ 

MENUITEM “& Dialog \ tF 2*，， IDM_DIALOG 
MENUITEM “ E & xit \ tCtrl + X ”, IDM_EXIT 

} 
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MENUITEM “&Help”, IDM_HELP 

} 


MyMenu ACCELERATORS 

{ 

VK_F2, IDM_DIALOG, VIRTKEY 
IDM_EXIT 

VK_F1, IDM_HELP, VIRTKEY 

} 

MyDB DIALOGEX 10, 10, 210, 110 
CAPTION “Books Dialog Box” 

STYLE WS_POPUP | WS_CAPTION | WS_SYSMENU | WS_VISIBLE 
| WS_BORDER 

{ 

DEFPUSHBUTTON “Author", IDD_AUTHOR, 11, 10, 36, 14 
PUSHBUTTON “Publisher” ， IDD_PUBLISHER, 11, 34, 36, 14 
PUSHBUTTON “Copyright”, IDD_COPYRIGHT, 11, 58, 36, 14 
PUSHBUTTON “Cancel”, IDCANCEL, 11, 82, 36, 16 
LISTBOX IDD_LB1, 60, 5, 140, 33, LBS_NOTIFY | WS_BORDER | 
WS_VSCROLL | WS_TABSTOP 
PUSHBUTTON “Select Book" , IDD_SELECT, 103, 41, 54, 14 
EDITTEXT IDD_EB1, 65, 73, 130, 12, ESJLEFT | 

WS_BORDER | ES_AUTHORSCROLL | WS_TABSTOP 
PUSHBUTTON “Title Search”, IDD_DONE, 107, 91 ， 46， 14 


이 프로그람을 다음과 같이 변경한다. 

• hDlg 라는 대 역변수를 추가하고 NULL 로 초기 화한다. 

• 통보문순환고려에 IsDialogMessage ( )를 추가한다. 

• DialogBox ( ) 가 아니 라 CreateDialog ( )로 대화칸을 작성 한다. 

• EndDialog ( ) 가 아니라 Destroy Window ( )로 대화칸을 닫는다. 

비양식 화대 화칸의 완성 된 실 례 프로그람을 실 례 5-3 에 주었 다. hDlg 에 특히 주목 
해 야 한다. 이 변수는 NULL 로 초기화된다. 대 화칸이 작성되 면 그의 손잡이 가 hDlg 에 
넣어 진다. 대화칸을 닫으면 hDlg 는 NULL 로 재설정된다. 따라서 hDlg 는 대화칸이 
능동상태 인 때 만 NULL 이 아닌 값으로 된다. hDlg 는 통보문순환고리 에서 검사되므로 
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무효한 손잡이로 IsDialogMessage ( ) 가 호출되는 일은 없다. 

프로그람의 실행결과를 그림 5-4 에 주었다. (이 프로그람을 보면 양식화대화칸과 비 
양식화대화칸과의 차이를 알수 있다.) 

실례 5-3. ModelessDialog 프로그람 


// 비 양식화대화칸의 실례 


itinclude 〈 windows. h> 
ttinclude <cstring> 
^include <cstdio> 
ttinclude "dialog, h” 

ttdefine NUMBOOKS 7 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
BOOL CALLBACK DialogFunc(HWND, UINT, WPARAM, LPARAM) ； 


char szWinNameG = n MyWin”; // 창문들라스의 이름 

HINSTANCE hlnst ； 

HWND hDlg = 0 ； // 대화칸의 손잡이 

// 서적자료기지 
struct booksTag { 
char title [40]; 
unsigned copyright ； 
char author [40] ； 
char publisher [40] ； 

} books [NUMBOOKS] = { 

{ "C++: The Complete Reference", 1998, 

” Herbert Schildt”, ，， Osborne/McGraw-Hill” }, 

{ "MFC Programming from the Ground Up”, 1998, 

"Herbert Schildt”, "Osborne/McGraw-Hill" }, 

{ "Java ： The Complete Reference", 1999, 

"Naughton and Schildt", "Osborne/McGraw-Hill" }, 

{ ” The C++ Programming Language”, 1997, 

교육성 프로그람교육쎈터 143 






Windows 2000 프로그람작성 법 


"Bjarne Stroustrup", "Addison-Wesley" }, 

{ "Inside OLE", 1995, 

"Kraig Brockschmidt", "Microsoft Press" }, 

{ "HTML Sourcebook", 1996, 

"Ian S. Graham", "John Wiley & Sons" }, 

{ "Standard C++ Library", 1995, 

"P. J. Plauger", "Prentice-Hall" | 

}； 

int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 

// 창문클라스를 정의한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ; 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이콘 
wcl. hlconSm = NULL ； // 큰 아이론의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 


// 차림표자원의 이름을 지정한다 . 
wcl. IpszMemiName = "MyMenu" : 

wcl. cbClsExtra = 0 ； // 보조기 억 기 령 역은 불필요함 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색은 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 

// 창문클라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 

/* 창문콜라스가 등록되 였으므로 
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창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Demonstrate a Modeless Dialog Box", // 제목 
WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CW_USEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결 정 하게 한다 . 
CW_USEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 

NULL, // 어미창문은 없다 . 

NULL, // 를라스차림 표의 덧쓰기는 하지 않는다 . 

hThisInst, // 실체의 손잡이 

NULL // 추가파라메 터 는 없 다 . 

)； 

hlnst = hThisInst; // 현재 실체의 손잡이를 보관한다 . 

// 가속기를 적재한다 . 

hAccel = LoadAccelerators (hThlsInst, "MyMenu") : 

// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성한다 . 

while(GetMessage (&msg, NULL, 0, 0)) 

{ 

if (IhDlg 11 ! IsDialogMessage (hDlg, &msg)) { 

// 대화칸통보문이 아닌 경우 

if ( ! TranslateAccelerator (hwnd, hAccel, &msg)) { 
TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage(&msg) : // Windows 2000 에 조종을 넘 긴 다 . 

} 



return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받는다 . 
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*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

int response; 

switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM_DIALOG: 

hDlg = CreateDialog(hlnst, ” MyDB", hwnd, 

(DLGPROC) DialogFunc) ； 

break ； 

case IDM_EXIT: 

response = MessageBox(hwnd, "Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O) ； 
break ； 

case IDM_HELP: 

MessageBox(hwnd, "No Help", "Help”, MB.OK) ； 
break ； 

} 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 

} 

return 0 ； 

} 

// 간단한 비 양식화대화함수 

BOOL CALLBACK DialogFunc (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 
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long i ； 

char str [255] ； 

switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDCANCEL: 

Destroy Window (hdwnd) ； 
hDlg = 0 ； // 손잡이를 무효로 한다 . 
return 1 ； 

case IDD_COPYRIGHT: 
i = SendDlgltemMessage (hdwnd, IDD_LB1, 

LB.GETCURSEL, 0, 0); // 색 인을 엄는다 . 
sprintf(str, "%u", books [i]. copyright) ； 

MessageBox(hdwnd, str, "Copyright", MB_OK); 
return 1 ； 

case IDD_AUTHOR ： 

i = SendDlgltemMessage (hdwnd, IDD_LB1, 

LB.GETCURSEL, 0, 0); // 색 인을 엄는다 . 
sprintf (str, "%s”, books [i]. author) | 

MessageBox (hdwnd, str, "Author”, MB_OK) ； 
return 1 ； 

case IDD.PUBLISHER ： 
i = SendDlgltemMessage (hdwnd, IDD_LB1, 

LB.GETCURSEL, 0, 0); // 색 인을 엄는다 . 
sprintf (str, ”%s”, books [i]. publisher) ； 

MessageBox (hdwnd, str, "Publisher”, MB_OK); 
return 1 ； 

case IDD.DONE ： // [Title Search] 단추가 눌러웠다 . 

// 편집 칸의 현재 내 용을 얻는다 . 

GetDlgltemText (hdwnd, IDD_EB1, str, 80); 

// 목록칸의 문자렬을 검 색 한다 . 

i = SendDlgltemMessage (hdwnd, IDD.LBl, LB_FINDSTRING, 

0, (LPARAM) str )； 

if(i != LB.ERR) { // 검색이 일치한 경우 
// 목록칸의 항목을 선택한다 . 

SendDlgltemMessage (hdwnd, IDD.LBl, LB.SETCURSEL, i, 0); 
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// 색인에 대응한 문자렬을 얻는다 . 

SendDlgltemMessage (hdwnd, IDD_LB1, LB_GETTEXT, 
i, (LPARAM) str )； 

// 색인에 대응한 문자렬을 엄는다 . 

SetDlgltemText(hdwnd, IDD_EB1, str )； 

} 

else 

MessageBox(hdwnd, str, "No Title Matching”, MB_OK) ； 
return 1 ； 

case IDD.LBl ： // 목록칸의 LBN_DBLCLK 를 처 러 한다 . 

// 사용자가 선택을 진행하였는가률 확인한다 . 
if (HIWORD (wParam) ==LBN_DBLCLK) { 
i = SendDlgltemMessage (hdwnd, IDD_LB1, 

LB.GETCURSEL, 0, 0 )； // 색 인을 얻는다 . 
sprintf (str, "%s \ n%s \ n%s, %u”, 

books [i]. title, books [i]. author, 
books [i]. publisher, books [i]. copyright); 

MessageBox(hdwnd, str, ” Selection Made”, MB_OK); 

// 색인에 대응한 문자렬을 얻는다 . 

SendDlgltemMessage (hdwnd, IDD_LB1, LB_GETTEXT, 
i, (LPARAM) str )； 

// 편집 칸을 갱신한다 . 

SetDlgltemText(hdwnd, IDD_EB1, str )； 

} 

return 1 ； 

case IDD.SELECT: // [Select Book] 단추가 눌러웠다 . 
i = SendDlgltemMessage (hdwnd, IDD_LB1, 

LB.GETCURSEL, 0, 0); // 색 인을 얻는다 . 
sprintf (str, "%s \ n%s \ n%s, %u”, 

books [i]. title, books [i]. author, 
books [i]. publisher, books [i]. copyright); 

MessageBox(hdwnd, str, ” Selection Made”, MB_OK) ； 

// 색인에 대응한 문자렬을 엄는다 . 

SendDlgltemMessage (hdwnd, IDD.LBl, LB_GETTEXT, 
i, (LPARAM) str )； 
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// 편집 칸을 갱 신한다 . 

SetDlgltemText (hdwnd, IDD_EB1, str); 
return 1 ； 

break ； 

case WMJNITDIALOG ： // 목록칸을 초기화한다 . 
for(i=0 ； KNUMBOOKS ； i++) 

SendDlgltemMessage (hdwnd, IDD_LB1, 

LB_ADDSTRING, 0, (LPARAM) books [i]. 社仕 e); 

// 첫 항목을 선택상래로 한다 . 

SendDlgltemMessage (hdwnd, IDD_LB1, LB_SETCURSEL, 0, 0) : 
// 편집 칸을 초기화한다 . 

SetDlgltemText (hdwnd, IDD_EB1, books [0]. title) : 


return 1 ； 


return 0 ； 
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여러가지 조종체 


이 장에서는 Windows 2000 의 표준적 인 조종체들중에서 세개의 새 조 
종체들을 취급한다. 이것들은 흘림띠，검사칸，단일선택단추이다. 5장에서 
학습한 조종체의 사용법을 이 장에서 배우는 조종체 에도 적용할수 있다. 

구체적으로는 먼저 흘림띠에 대 한 설명으로부터 시 작하여 간단한 실례 
프로그람을 작성해본다. 흘림띠는 다른 조종체들보다 취급하기 시끄럽지만 
그다지 어려운것은 아니다. 

다음에 검 사칸과 단일 선택단추에 대 하여 학습한다. 흘림띠，검 사칸， 
단일선택단추의 기본적 인 사용법 을 보여 주기 위하여 간단한 내 려세기시계 
프로그람을 작성한다. 이 프로그람을 작성할 때 시계 의 새 치기와 
的여/ _77 ME 於 통보문에 대한 설명을 한다. 이 장에서는 Windows 의 정적 
조종체에 대하여서도 학습한다. 
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를 림 띠 


를림띠는 Windows 의 조종체들중에서 가장 중요한것의 하나로서 두가지 종류가 있 
다. 첫번째 종류는 완전히 창문이나 대화칸의 일부로 되는것인데 이것을 표준를림 [[M \ 五 
한다. 두번째 종류는 조종체 로서 독립적으로 존재하는것 인데 이젓을 를림띠조종제라고 
한다. 어느 종류의 홀림띠라고 해도 거의나 같은 방법으로 취급할수 있다. 

참문에 표준를림[[I 의 추가 

창문에 표준홀림띠를 추가하려면 몇가지 설정을 해 야 한다. 응용프로그람의 기본창 
문에서 CreateWindow() 를 사용하여 창문을 작성 할 때 창문의 형식을 설정 하는 파라메 
터 에 的石幻 Z 丄이 나 WS—HSCROLL 을 지 정하면 표준흘림띠 가 추가된 다. 

대 화칸인 경 우에 는 자원파일 에 서 대 화칸의 형 식 을 정 의 할 때 WS_VSCROLL 나 
WS_HSCROLL 을 지 정한다. 말그대 로 WS_VSCROLL 은 수직 흘림 띠 , WS_HSCROLL 
은 수평홀림띠를 추가한다. 이러한 형식들을 지정하면 수직홀림띠나 수평흘림띠가 자동 
적으로 창문에 추가된다. 

를림[[ᅵ 를보문의 처 리 

다른 조종체와는 달리 표준흘림띠 나 흘림띠조종체는 WM_COMMAND 통보문을 생 
성 하지 않는다. 그대 신 수직 흘림 띠 나 수평 흘림 띠 를 조작하면 WS_VSCROLL 이 나 
WS_HSCROLL 통보문이 생성된다. 이때 wParam 의 아래단어의 값은 조작내용을 가려 
킨다. 표준흘림띠 에서 lParam 은 령 이 다. 그러 나 홀림띠조종체 가 생성한 통보문인 경우 
에 는 lParam 에 조종체 의 손잡이 가 보관된 다. LOWORD (wParam) 의 값은 흘림 띠 에 어 
떠한 조작이 가해졌는가를 가러킨다. 주되는 값은 아래와 같다. 


SB_LINEUP 

SB_LINEDOWN 

SB—PAGEDOWN 

SB—PAGEUP 

SB_LINELEFT 


SB—LINERIGHT 

SB—PAGELEFT 

SB_PAGERIGHT 

SB_THUMBPOSITION 

SB—THUMBTRACK 


수직흘림띠에서는 사용자가 수직흘림띠를 웃방향으로 움직 이면 SB_LINEUP 이 발송 
되 며 흘림 띠 를 아래 방향으로 이 동하면 SB_LINEDCWN <>] 발송된 다. SB—PAGEUP ， 
SB_PAGEDOWN 은 폐 지 단위 로 흘림 띠 를 아래 우로 움직 였을 때 발송된다. 
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수평흘림 띠 에서 는 사용자가 흘림 띠 를 왼쪽으로 이동하면 SB_LINELEFT 가 발송된다. 
흘림띠를 오른쪽으로 이동하면 SB—LINERIGHT 가 발 송된 다. SB—PAGELEFT ， 
SB_PAGERIGHT 는 폐지단위 로 흘림띠를 좌우로 움직 였을 때 발송된다. 

어떤 형태의 홀림띠에서든지 SB_THUMBPOSITION 은 흘림띠의 를림칸이 새로운 위 
치에 이동된 다음에 발송된다. 또한 SB—THUMBTRACK 도 홀림 칸이 새로운 위 치에 이 
동될 때 발송된다. 이것들의 차이는 SB_THUMBTRACK 는 홀림 칸이 새로운 위 치 에로 
이 동하는 도중에 발송된 다는것 이 다. 이 렇 게 하여 홀림 칸을 놓기 전에 이 동위 치 를 추적 할 
수 있다. 

SB_THUMBPOSITION 또는 SB_THUMBTRACK 를 받았을 때 wParam 의 웃단어 
에는 현재 홀림칸의 위 치가 보관되 여 있다. 

이식과 관련한 요점 : 16bit 판 Windows 에서는 여기에서 설 명 하는 wParam 파 IParam 
의 역할이 Windows 2000 과 다르다 . 즉 홀림띠의 손잡이는 IParam 의 웃단어에，홀림칸 
의 위치는 Iparam 의 아래단어에 그리고 흘림띠의 조작내용은 wParam 에 보관되여 있다 . 
이러한 차이점이 있으므로 16bit 판 Windows 의 프로그람코드를 Windows 2000 에 이식 
하려면 홀럼띠통보문을 처러하는 부분을 모두 바꾸어 써넣어야 한다 . 


SetScrollnfo( ) 와 GetScrolllnfo( ) 

홀림띠는 많은 부분을 수동적으로 조작하여야 하는 조종체이다. 이것은 홀림띠통보문 
의 처리뿐아니라 프로그람코드에서 흘림띠와 관련되는 여러가지 속성들을 설정해야 한다 
는것을 의미한다. 례를 들면 프로그람코드에서 를 림^^와 위치를 설정해 주어야 한다. 

Windows 2000 은 흘림띠를 조작하기 위 한 두개의 함수를 제공한다. Set 效 : rollInfo( ) 항 
수는 홀림띠와 관련되는 다양한 속성들의 설정을 진행한다. 아래에 선언을 보여 주었다. 

int SetScrollInfo ( HWND hwnd , int which , LPSCROLLINFO IpSI , 

BOOL repain ) : 

hwnd 는 흘림띠를 식 별하기 위 한 손잡이 이 다. 창문에 추가된 표준흘림띠 에서는 이 
손잡이 에 홀림 띠 가 포함된 창문의 손잡이 를 설정 한다. 흘림띠 조종체 에서 는 홀림 띠 자체 
의 손잡이를 설정한다. 

which 의 값은 대상으로 되는 홀림띠를 지정한다. 창문에 추가된 수직흘림띠의 속 
성 을 지정 하는 경 우는 이 파라메 터 에 SB—VERT 를 설정 한다. 창문에 추가된 수평 흘림 
띠 의 속성 을 설 정 하는 경 우는 SB—HORZ 를 설정 한다. 흘림 띠 조종체 의 경 우에 는 이 파라 
메 터 에 SB_CTL 을 설정 하고 hwnd 에 조종체 의 손잡이 를 설정 한다. 

속성 에 대 한 정 보는 IpSI 에 설정 한다 . ( 뒤 에 서 상세 한 설명 을 준다. ) repaint 파라 
메터가 TRUE 인 경우에는 흘림띠 가 다시그리기되 고 FALSE 인 경우에는 다시그리기되 
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지 않는다. 이 함수는 홀림칸의 위 치를 돌려 준다. 흘림띠와 관련한 속성을 얻기 위해서 
는 GetScrollInfo () 를 사용한다. 아래 에 선언을 보여 주었 다. 

BOOL GetScrollInfo(HWND hwnd , int which , LPSCROLLINFO IpSI ); 

hwnd 와 which 의 의 미 는 SetScrollInfo ( ) 에 서 설 명 한 것 과 같 다 . 
GetScrollInfo ( ) 에서 얻는 정보는 IpSI 가 가러키는 지시자에 보관된다. 호출이 성공하 
면 함수는 령 이 아닌 값을 돌려 주며 실패하면 령을 돌려 준다. 

어 느 함수에 서 나 IpSI 의 자료형 은 SCi ? 幻 Z 丄 / AF 幻 구조체 형 으로 된 다. 아래 에 그의 
정의를 표시한다. 


typedef struct tagSCROLLINFO 


UINT cbSize； 
UINT fMask； 
int nMin； 
int nMax； 
UINT nPage 
int nPos； 
int nTrackPos； 


// SCROLLINFO 구조체 의 크기 

// 조작내용 

// 최소값 

// 최대값 

// 폐지의 값 

// 흘림칸의 위 치 

// 탐색중의 현재위치 


SCROLLINFO； 


cbSize 에는 SCROLUNF ◦ 구조체의 크기를 설정한다. fMask 에 설정하거나 보관 
되 여 있는 값은 나머지 파라메터 에서 유효한것 이 어 느것 인가를 가리킨다. 
SetScrollInfoC )를 호출하는 경우에는 흘림띠의 어느 속성을 설정하는가를 fMask 에서 
지정 한다. GetScrollInfo ( )를 호출하는 경우에는 어느 속성을 얻는가를 fMask 에서 지 
정 한다. fMask 의 값은 아래 에 준 값 또는 그것 들을 조합한 값이 여 야 한다. (값을 조합하 
는 경 우에 는 OR 연산자를 사용한다. ) 


SIF—ALL 

SIF_PAGE | SIF_POS | SIF_RANGE | 

SIF TRACKPOS 와 동일 하다. 

SIF_DISABLENOSCROLL 

범위가 령이여도 흘림띠를 삭제하지 않고 무효 
로 한다. 

SIF PAGE 

nPage 에 유효한 값이 설정되 여 있다. 

SIF POS 

nPos 에 유효한 값이 설정되 여 있다. 

SIF RANGE 

nMin 과 nMax 에 유효한 값이 설정되 여 있다. 

SIF TRACKPOS 

nTrackPos 에 유효한 값이 설정되 여 있다. 
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nPage 는 흘림띠의 크기에 비례한 폐지의 값을 표시한다. nPos 는 흘림칸의 위치를 
표시 한다. nMin 및 nMax 는 홀림 띠의 범위의 최소값 및 최대값을 가리 킨 다. 
nTrackPos 에는 람색중의 현재위치가 설정된다. 람색중의 현재위 치 란 탐색중의 흘림칸 
의 현재위 치이 다. 이 값은 참조만 가능하다. 

이식과 관련한 요점 : Winl 6 프로그람에서 는 홀림 띠의 설정을 진행 하는데 
SetScrollRange ( ) 와 SetScrollPos ( ) 라는 API 함수를 사용한다. 이 함수들은 Win 32 에 
서도 지원되고 있으나 프로그람을 이식할 때는 SetScrollInfo ( ) 로 변경할것을 권고한다. 

를림[[ I 의 사용방법 

앞에서 설명한바와 같이 홀림띠는 수동으로 조작하는 조종체이다. 이것은 홀림띠가 
이동되 였을 때 홀림칸의 위 치를 프로그람코드에서 설정 해 야 한다는것을 의미 한다. 이것 
을 실현하려 면 nPos 에 새 로운 위 치를 설정 하고 fMask 에 SIF_POS 를 설정 하여 
SetScrollInfo ( )를 호출한다. 례를 들어 수직홀림띠의 위치를 갱신하기 위해서는 다음 
과 같이 프로그람코드를 서술한다. 


SCROLLINFO si ； 

"... 

si.cbSize = sizeof (SCROLLINFO) : 
si. fMask = SIF_POS ； 
si.nPos = newposition ； 

SetScrollInfoChwnd, SB.VERT, &si, 1 )； 

흘림띠의 범위는 흘림띠의 끝에서 끝까지 얼마만한 자리가 있는가를 결정한다. 창 
문에 추가되는 표준흘림띠의 범위는 체계설정값으로 0〜100 으로 되여 있다. 이 값들은 
프로그람의 목적에 따라 변경시킬수 있다. 

흘림띠조종체의 범위는 체계설정값으로서 0〜0 으로 되여 있다. 그러므로 홀림띠조 
종체를 사용하기에 앞서 범위를 설정하여야 한다. (범위가 령으로 설정되여 있는 홀림띠 
는 동작하지 않는다.) 범위를 설정하면 프로그람에서 홀림칸의 위치를 쉽게 관리할수 있 
게 된다. 


흘림[[ I 의 실례프로그람 


이제부터 작성하게 되는 프로그람은 수직 및 수평 홀림띠를 관리하는 실례프로그람 
이다. 이 프로그람은 아래의 자원파일을 필요로 한다. 
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// 흘림띠의 실례 
#include “scroll, h” 

♦include <windows.h> 

MyMenu MENU 

{ 

POPUP “&Dialog” 

{ 

MENUITEM “&Scroll Bars\F2" ， IDM_DIALOG 
MENUITEM << E&xit\Ctrl+X ,, ) IDM_EXIT 

} 

MENUITEM “&Help”, IDM_HELP 

} 

MyMenu ACCELERATORS 

{ 

VK_F2, IDM_DIALOG, VIRTKEY 

『 X”, IDM_EXIT 

VK_F1, IDM_HELP, VIRTKEY 

} 

MyDB DIALOGEX 18, 18, 142, 92 
CAPTION “Using Scroll Bars” 

STYLE DS_MODALFRAME | WS_POPUP | WS_CAPTION | 

WS_SYSMENU | WS_VSCROLL | WS_HSCROLL 

{ 

} 

보는바와 같이 현재는 대화칸의 정의가 비여 있다. 형식에 WS_VSCROLL 과 
WS_HSCROLL 을 지 정하면 대 화칸에 흘림 띠 가 자동적 으로 추가된 다. 

아래 와 같은 내 용의 SCROLL . H 라는 머 리 부파일 도 필 요하다. 

#define IDM_DIALOG 100 

#define IDM_EXIT 101 

#define IDM_HELP 102 

실례 6-1 에 홀림띠의 적용실례를 보여 주는 완전한 프로그람코드를 주었다. 수직홀림 
띠는 흘림칸을 움직일 때 SB_LINEUP ， SB_LINEDOWN, SB_PAGEUP, SB_PAGEDOWN, 
SB-THUMBPOSITION 말 SB_ THUMBTRACK 호 ] 각 통보문에 응답한다. 홀림 칸의 현재 
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위 치도 표시된다. (수평홀림띠가 다른 통보문들에도 응답하게 하려면 펼요한 프로그람코드 
를 추가하여야 한다.) 홀림칸을 움직이면 위치의 표시가 변화된다. 

수평 흘림띠는 SBJJNELEFT 말 SB—LINERIGHT 에 민: 응답한다. 흘림 칸의 위 치도 
표시된다. (수평홀림띠가 다른 통보문들에도 응답하게 하려면 필요한 프로그람코드를 추 
가하여 야 한다.) 

수직흘림띠 및 수평홀림띠의 범위는 대 화칸이 WMJNITDIALOG 통보문을 받았을 
때 설정된다는 점에 주목해야 한다. 흘림띠의 범위를 변경하고 그 결과를 확인할수도 
있 다. 

또 하나의 중요한 점은 매 홀림띠의 흘림칸의 위치가 TextOut ( )를 리용하여 대화 
칸의 의 뢰 자구역 에 표시 된 다는것 이 다. 대 화칸은 특정 한 용도에 사용되 는것 이 지 만 기 본창 
문과 같은 기능을 가지는 창문이라는데는 다른 점이 없다. 프로그람의 실행결과를 그림 
6-1 에 보여 주었다. 



그림 6-1. 표준를림 m 실례프로그람의 실행결과 


실례 6-1. Scroll 프로그람 
// 표준흘림띠의 실례 

♦include < windows. h> 
♦include <cstring> 
♦include <cstdio> 
♦include "scroll, h" 


♦define VERTRANGEMAX 200 
ttdefine HORZRANGEMAX 50 
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LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM); 
BOOL CALLBACK DialogFunc(HWND, UINT, WPARAM, LPARAM) : 

char szWinName[] = ” My Win”; // 창문믈라스의 이름 


HINSTANCE hlnst ； 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 

// 창문물라스를 정의 한다 . 

wcl. cbSize = sizeof (WNDCLASSEX) : 


wcl.Mnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문콜라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이 콘 

wcl. hlconSm = NULL ； // 큰 아이론의 축소판을 사용한다 . 

wcl. hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

// 차림표자원의 이름을 지정한다 . 
wcl. IpszMenuName = "My Menu" : 

wcl. cbClsExtra = 0 ； // 보조기 억기령 역은 불필 요함 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색은 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 


// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 
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/* 창문콜라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Managing Scroll Bars", // 제목 

WS_OVERLAPPEDWINDOW, II 창문의 형식은 표준으로 한다 . 
CW_USEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없음 

NULL, // 믈라스차림 표의 덧쓰기는 하지 않는다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없음 

)； 


hlnst = hThisInst ； // 현재 실체의 손잡이를 보관한다 . 
// 가속기를 적재 한다 . 

hAccel = LoadAccelerators (hThisInst, "MyMenu") : 

// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) ; 

UpdateWindow (hwnd ); 


// 통보문순환고리를 작성 한다 . 

while(GetMessage(&msg , NULL, 0, 0)) 

{ 

if (! TranslateAccelerator (hwnd, hAccel, &msg)) { 
TranslateMessage(&msg); // 건반통보를 변환한다 . 
DispatchMessage(&msg) ; // Windows 2000 에 조종을 넘 긴 다 . 

} 


return msg.wParam; 

} 
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/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받는다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

int response ； 


switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM_DIALOG: 

DialogBox(hInst, ” MyDB", hwnd, (DLGPROC) DialogFunc) ； 
break ； 

case IDM.EXIT ： 

response = MessageBox(hwnd, "Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O) ； 
break ； 

case IDM_HELP: 

MessageBox(hwnd, "Try the Scroll Bar", "Help，，, MB_OK); 
break ； 

} 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

A 이 switch 문에서 지정되지 않은 통보문들은 
Windows 2000 이 처 리 하게 한다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 


return 0 ； 

} 

// 대화함수 

BOOL CALLBACK DialogFunc (HWND hdwnd, UINT message, 
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WPARAM wParam, LPARAM IParam) 

{ 

char str [80] ； 

static int vpos = 0; // 수직흘림띠의 흘림 칸의 위 치 
static int hpos = 0 ； // 수평흘림띠의 흘림 칸의 위 치 
static SCROLLINFO si ； // 흘림띠의 정보를 보관하는 구조체 

HDC hdc ； 

PAINTSTRUCT paintstruct ； 


switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDCANCEL: 

EndDialog (hdwnd, 0 )； 
return 1 ； 

} 

break ； 

case WMJNITDIALOG ： 
si.cbSize = sizeof (SCROLLINFO) ； 
si.fMask = SIF_RANGE ； 
si.nMin = 0 ； si.nMax = VERTRANGEMAX ； 
SetScrollInfo (hdwnd, SB_VERT, &si, 1); 
si.nMax = HORZRANGEMAX ； 

SetScrollInfo(hdwnd, SB_HORZ, &si, 1 )； 
vpos = hpos = 0; 
return 1 ； 
case WM.PAINT: 

hdc = BeginPaint (hdwnd, &paintstruct) ； 
sprintf(str, "Vertical: %d”, vpos); 

TextOut (hdc, 1, 1, str, strlen(str)) ； 
sprintf(str, "Horizontal: %d”, hpos) ； 
TextOut (hdc, 1, 30, str, strlen(str)) ； 
EndPaint (hdwnd, ^paintstruct) ； 
return 1 ； 

case WM_VSCROLL ： 
switch (LOWORD (wParam)) { 
case SB.LINEDOWN ： 
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VPOS++； 

if (vpos»VERTRANGEMAX) vpos = VERTRANGEMAX ； 
break ； 

case SB.LINEUP ： 
vpos 一一 ； 

if (vpos<0) vpos = 0; 
break ； 

case SB.THUMBPOSITION : 
vpos = HIWORD(wParam); // 현재위치를 엄는다 . 
break ； 

case SB.THUMBTRACK : 
vpos = HIWORD(wParam); // 현재위치를 엄는다 . 
break ； 

case SB_PAGEDOWN: 
vpos += 5 ； 

if (vpos 》 VERTRANGEMAX) vpos = VERTRANGEMAX ； 
break ； 

case SB_PAGEUP ： 
vpos -= 5; 
if (vpos<0) vpos = 0; 

} 

// 수직흘림띠의 위치를 갱신한다 . 
si. f Mask = SIF.POS ； 
si.nPos = vpos ； 

SetScrollInfo(hdwnd, SB.VERT, &si, 1 )； 

hdc = GetDC(hdwnd) ； 

sprintf(str, "Vertical ： %d ”, vpos) ； 

TextOutChdc, 1, 1, str, strlen(str)) ； 

ReleaseDC (hdwnd, hdc) ； 
return 1 ； 

case WM.HSCROLL ： 
switch (LOWORD (wParam)) { 

/* 여기에 수평흘림띠의 다른 통보문들을 처리하는 
프로그람코드률 추가하여 본다 . */ 
case SB.LINERIGHT ： 
hpos ++； 

if (hpos»HORZRANGEMAX) hpos = HORZRANGEMAX; 
break ； 
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case SB.LINELEFT ： 
hpos -- ； 

if(hpos<0) hpos = 0 ； 

} 

// 수평흘림띠의 위치를 갱신한다 . 
si.fMask = SIF.POS ； 
si.nPos = hpos ； 

SetScrollInfo (hdwnd, SB_HORZ, &si, 1); 

hdc = GetDC(hdwnd) ； 

sprintf(str, "Horizontal: %d ”, hpos); 

TextOut(hdc, 1, 30, str, strlen(str)) ； 

ReleaseDC (hdwnd, hdc) ； 

return 1 ； 


return 0 ； 

} 

흘림띠조종체의 사용방법 


를림띠조종제는 독자적 인 흘림 띠 이 며 창문에 추가된것 이 아니 다. 홀림 띠 조종체 는 
표준홀림띠와 거의 같은 방법으로 조작할수 있지만 두가지 큰 차이점 이 있다. 

첫번째 차이는 흘림띠조종체의 범위가 체계설정으로서 령으로 되여 있다는것이며 그 
것을 반드시 설정해야 한다는것이다. 그러므로 초기에는 동작할수 없는 상태로 되여 있 
다. 이것은 체계설정의 범위가 0〜100 으로 되여 있는 표준홀림띠와 다르다. 두번째 차 
이점은 휼림띠의 통보문을 받았을 때 IParam 에 보관되 여 있는 값의 의미 이 다. 

표준홀림띠 와 흘림띠조종체 는 모두 흘림띠 가 수평 또는 수직 인가에 따라 
WM—HSCROLL 통豆문 혹은 的^ KSCff 幻 Z 소통보문을 받아 들인다는것을 상기해 볼 필요 
가 있다. 이 통보문들을 표준홀림띠가 생성 한 경우에 IParam 의 값은 항상 령 이 다. 이 
와는 달리 흘림띠조종체 가 통보문을 생성한 경우는 IParam 에 조종체의 손잡이가 보관되 
여 있다. 표준흘림띠와 흘림띠조종체를 다 가지고 있는 창문에서는 어느 흘림띠가 통보 
문을 생성하였는가를 구별해 야 할 필요가 있다. 

를림띠조종제의 작성 

흘림 띠 조종체 를 작성 하려 면 자원파일 에 서 SCROLLBAR 명 령 문을 사용한다. 아래 에 
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일반적인 서식을 보여 주었다. 

SCROLLBAR SBID , X , Y , Width , Height ^ Stylej 

SBID 는 흘림 띠 를 식 별 하는 값이 다. 흘림 띠 의 왼쪽웃모서 리의 자리 표를 X , Y 에 설 
정하고 흘림띠의 크기를 Width 및 Height 에 설정한다. 흘림띠의 형식은 Style 에 설정 
한다. 체계설정형식은 모 Z 이며 이에 의해 수평홀림띠가 작성된다. 건입력초점 

을 받는 홀림띠로 하려는 경우는 형식에 WS — TABSTOP 를 포함시킨다. 

를림[[ I 조종체의 실례 

흘림띠조종체의 실례를 보여 주기 위해 앞에서 작성한 프로그람을 부분적으로 개조해 
보자. 우선 다음과 같이 대화칸의 정의를 변경한다. 여기서는 수직흘림띠를 추가해본다. 

MyDB DIALOGEX 18, 18, 142, 92 
CAPTION “Adding a Control Scroll Bar” 

STYLE DS MODALFRAME | WS_POPUP | WS_CAPTION | 

WS_SYSMENU | WS_VSCROLL | WS_HSCROLL 

{ 

SCROLLBAR ID_SB1, 110, 10, 10, 70, SBS_VERT | WS_TABSTOP 

} 

그리 고 SCROLL . H 에 다음의 한 행 을 추가한다. 


ttdefine ID_SB1 200 


다음 홀림띠조종체를 조작하기 위한 프로그람코드를 추가한다. 이 프로그람코드는 
WM_VSCROLL 통보문을 생 성 하는 표준흘림 띠 와 흘림 띠 조종체 를 구별 한다. 

흘림띠조종체 가 IParam 에 손잡이를 보관한다는것을 고려하여 야 한다. 표준흘림띠 
에서 IParam 의 값은 령 이 다. 례 를 들어 아래 의 SB_LINEDOWN 의 case 문은 표준홀림 
띠와 흘림띠조종체를 구별한다. 

case SBJLINEDOWN: 

if ((HWND) lParam==GetDlgItem (hdwnd, ID_SB1)) { 

// 흘림띠조종체 이다 . 
cn 仕 pos++; 

if (cntlpos»VERTRANGEMAX) cntlpos = VERTRANGEMAX ； 

} 
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else { 

// 표준흘림띠이다. 
vpos ++； 

if (vpos»VERTRANGEMAX) vpos = VERTRANGEMAX ； 

} 

break ； 

이 프로그람 코드에 서 는 IParam 에 보관된 손잡이 가 GetDlgItem ( H 사 얻 은 흘림 띠 
조종체의 손잡이와 비교되고 있다. 손잡이의 값이 같다면 통보문이 흘림띠조종체에 의 
해 생성 되 였다는것 을 알수 있다. 그렇 지 않은 경우에 통보문은 표준흘림띠 에 의해 생성 
되 였 다는것 이 다. 

5 장에서 설명 한것 처 럼 GetDlgItem ( M 라는 API 는 조종체 의 손잡이 를 돌려 준다. 
다시 한번 선언을 보여 주었다. 

HWND GetDlgItem(HWND hDwnd, int ID)； 

hDwnd 는 조종체가 속한 대화칸의 손잡이 이다. 조종체를 식별하는 값은 ID 에 설정 
된다. 이것은 자원파일에서 조종체에 지정한 값이다. 이 함수는 지정된 조종체의 손잡이 
를 돌려 주며 함수의 호출이 실패한 경 우는 NULL 을 돌려 준다. 

실례 6-2 에 홀림띠조종체를 취급하는 실례프로그람을 보여 주었다. 이것은 몇가지 
점을 내놓고는 앞에서 작성한 프로그람코드와 같다. DialogFunc( ) 에서 흘림띠조종체 
의 위치를 보관하기 위한 변수 cntlpos 가 선언된다. 홀림띠조종체는 WMJNITDIALOG 
에서 초기화된다. WM_VSCROLL 통보문을 처리 하는 부분에서는 통보문이 표준흘림 띠와 
흘림띠조종체중 어느것에서 보낸것인가를 판정 한다. 휼림띠조종체의 현재위치를 표시 하 
기 위한 프로그람코드도 추가되 였 다. 

실례 6-2. ScrollControl 프로그람 

// 흘림띠조종체의 실례프로그람 

#include 〈 windows. h> 

♦include <cstring> 

♦include <cstdio> 

♦include "scroll, h" 


#define VERTRANGEMAX 200 
ttdefine HORZRANGEMAX 50 

LRESULT CALLBACK WindowFunc (HWND ， UINT, WPARAM, LPARAM); 
BOOL CALLBACK DialogFunc(HWND, UINT, WPARAM, LPARAM); 
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char szWinName[] = ” My Win”; // 창문믈라스의 이름 
HINSTANCE hlnst ； 

int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 

// 창문물라스를 정의 한다 . 

wcl. cbSize = sizeof (WNDCLASSEX) : 


wcl.hlnstance = hThisInst; // 실체의 손잡이 
wcl. li 犯 zClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정형식 


wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이론 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 

// 차림표자원의 이름을 지정한다 . 
wcl. IpszMenuName = "My Menu" : 

wcl. cbClsExtra = 0; // 보조기 억 기 령 역은 불필요함 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 

// 창문들라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 

/* 창문클라스가 등록되 였으므로 
창문을 작성할수 있다 . 비 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Managing Scroll Bars", // 제목 

WS_OVERLAPPEDWINDOW, II 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
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CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결 정 하게 한다 . 
CW_USEDEFAULT, // 창문의 너 비는 Windows 가 결정하게 한다 . 
CW_USEDEFAULT, // 창문의 높이는 Windows 가 결정 하게 한다 . 


// 어미창문은 없다 . 

// 콜라스차림 표의 덧쓰기는 하지 않는다 . 
// 실체의 손잡이 
// 추가파라메터 는 없음 


NULL, 

NULL ， 


hThisInst, 

NULL 


hlnst = hThisInst ； // 현재 실체의 손잡이를 보관한다 . 

// 가속기를 적재한다 . 

hAccel = LoadAccelerators (hThisInst, "MyMenu") : 

// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while(GetMessage(&msg , NULL, 0, 0)) 

{ 

if(! TranslateAccelerator(hwnd, hAccel, &msg)) { 
TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage(Smsg) ; // Windows 2000 에 조종을 넘 긴다 . 

} 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받는다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 


WPARAM wParam, LPARAM IParam) 
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switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM—DIALOG: 

DialogBox(hInst, ” MyDB”, hwnd, (DLGPROC) DialogFunc) ； 
break ； 

case IDM.EXIT ： 

response = MessageBox(hwnd, "Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O); 
break ； 

case IDM_HELP: 

MessageBox(hwnd, "Try the Scroll Bar", ” Help”, MB_OK) ； 
break ； 

} 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQu 仕 Message (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, lParam); 


return 0 ； 

} 

// 대화함수 

BOOL CALLBACK DialogFunc (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM lParam) 

{ 

char str [80] ； 

static int vpos = 0; // 수직흘림띠의 흘림 칸의 위 치 

static int hpos = 0 ； // 수평흘림띠의 흘림칸의 위 치 

static int cntlpos = 0 ； // 흘림띠조종체의 흘림 칸의 위 치 
static SCROLLINFO si ； // 흘림띠정보률 보관하는 구조체 
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HDC hdc ； 

PAINTSTRUCT paintstruct ； 


switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDCANCEL ： 

EndDialog (hdwnd, 0); 
return 1 ； 

} 

break ； 

case WM.INITDIALOG ： 
si.cbSize = sizeof (SCROLLINFO) ； 
si. f Mask = SIF.RANGE ； 
si.nMin = 0 ； si.nMax = VERTRANGEMAX ； 

// 표준수직흘림띠의 위치를 설정한다 . 

SetScrollInfo(hdwnd, SB.VERT, &si, 1 )； 

// 흘림띠조종체의 범위를 설정한다 . 

SetScrollInfo(GetDlgltem(hdwnd, ID_SB1), SB_CTL, &si, 1 )； 

si.nMax = HORZRANGEMAX; 

// 표준수평흘림띠의 범위를 설정한다 . 

SetScrollInfo(hdwnd, SB.HORZ, &si, 1); 

vpos = hpos = cntlpos = 0 ； 
return 1 ； 
case WM_PAINT ： 

hdc = BeginPaint (hdwnd, ^paintstruct) ； 
sprintf(str, "Vertical: %d”, vpos); 

TextOut(hdc, 1, 1, str, strlen(str)) ； 
sprintf(str, "Horizontal: %d”, hpos) ； 

TextOut(hdc, 1, 30, str, strlen(str)); 

sprintf(str, ” Scroll Bar Control: %d ", cntlpos) ； 

TextOut (hdc, 1, 60, str, strlen(str)) ； 

EndPaint (hdwnd, ^paintstruct) ； 
return 1 ； 
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case WM_VSCROLL ： 

/* 여기에서는 통보문을 생성한것이 

흘림 띠조종체 인가 표준흘림 띠인가를 판정 해 야 한다 . */ 
switch (LOWORD (wParam)) { 
case SB_LINEDOWN ： 

if ((HWND) lParam==GetDlgItem (hdwnd, ID_SB1)) { 

// 흘림띠조종체 이 다 . 
cntlpos ++； 

if (cntlpos»VERTRANGEMAX) cntlpos = VERTRANGEMAX ； 

} 

else { 

// 표준흘림띠 이다 . 
vpos++ ； 

if(vpos»VERTRANGEMAX) vpos = VERTRANGEMAX ； 

} 

break ； 

case SB_LINEUP ： 

if ((HWND) lParam==GetDlgItem (hdwnd, ID_SB1)) { 

// 흘림띠조종체 이 다 . 
cntlpos— : 

if(cntlpos<0) cntlpos = 0 ； 

} 

else { 

/* 표준흘림띠 이 다 . */ 
vpos —； 

if(vpos<0) vpos = 0 ； 

} 

break ； 

case SB_THUMBPOSITION : 
if ((HWND) lParam==GetDlgItem (hdwnd, ID_SB1)) { 

// 흘림띠조종체 이 다 . 

cntlpos = HI WORD (wParam) ; // 현재위치를 얻 는다 . 

} 

else { 

// 표준흘림 띠 이다 . 

vpos = HIWORD(wParam); // 현재위치를 얻는다 . 

} 

break ； 
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case SB_THUMBTRACK ： 

if ((HWND) lParam==GetDlgItem (hdwnd, ID_SB1)) { 

// 흘림띠조종체 이다 . 

cntlpos = HIWORD(wParam) : // 현재위 치를 얻는다 . 

} 

else { 

// 표준흘림띠 이 다 . 

vpos = HIWORD(wParam) : // 현재위 치를 엄는다 . 

} 

break ； 

case SB_PAGEDOWN ： 

if ((HWND) lParam==GetDlgItem (hdwnd, ID_SB1)) { 

// 홀림띠조종체 이 다 . 
cntlpos += 5; 

if (cntlpos»VERTRANGEMAX) cntlpos = VERTRANGEMAX ； 

} 

else { 

// 표준흘림띠 이다 . 
vpos += 5 ； 

if(vpos»VERTRANGEMAX) vpos = VERTRANGEMAX ； 

} 

break ； 

case SB_PAGEUP : 

if ((HWND) lParam==GetDlgItem (hdwnd, ID_SB1)) { 

// 홀림띠조종체 이 다 . 
cntlpos -= 5 ； 
if(cntlpos<0) cntlpos = 0 ； 

} 

else { 

// 표준흘림띠 이다 . 
vpos -= 5 ； 
if(vpos<0) vpos = 0 ； 

} 

break ； 

} 


if ((HWND) lParam==GetDlgItem (hdwnd, ID_SB1)) { 
// 흘림띠조종체의 위치를 갱신한다 . 
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si. f Mask = SIF.POS ； 
si.nPos = cntlpos; 

SetScrollInfo ((HWND) IParam, SB_CTL, &si, 1 )； 
hdc = GetDC(hdwnd) ； 

sprintf(str, "Scroll Bar Control ： %d ”, cntlpos) ； 
TextOut(hdc, 1, 60, str, strlen(str)) ； 

ReleaseDC(hdwnd, hdc); 

} 

else { 

// 표준흘림띠의 위치를 갱신한다 . 
si.fMask = SIF.POS ； 
si.nPos = vpos ； 

SetScrollInfo (hdwnd, SB.VERT, &si, 1 )； 

hdc = GetDC(hdwnd) ； 

sprintf(str, "Vertical ： %d ”, vpos) ； 

TextOut(hdc, 1, 1, str, strlen(str)) ； 

ReleaseDC (hdwnd, hdc) ； 

} 

return 1 ； 

case WM.HSCROLL ： 
switch (LOWORD (wParam)) { 

/* 여기에 수평흘림띠의 다른 사건을 처리하는 
프로그람코드를 추가할수 있다 . 비 
case SB_LINERIGHT: 
hpos++; 

if (hpos»HORZRANGEMAX) hpos = HORZRANGEMAX ； 
break ； 

case SB.LINELEFT ： 
hpos -- ； 

if(hpos<0) hpos = 0 ； 

} 

// 수평흘림띠의 위치를 갱신한다 . 
si.fMask = SIF.POS ； 
si.nPos = hpos ； 

SetScrollInfo(hdwnd, SB_HORZ, 技 si, 1); 

hdc = GetDC(hdwnd) ； 

sprintf(str, "Horizontal ： ”, hpos); 

TextOut(hdc, 1, 30, str, strlen(str)) ； 
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ReleaseDC (hdwnd, hdc) ； 
return 1 ； 


return 0 ； 

} 

프로그람의 실행결과를 그림 6-2 에 보여 주었다. 수평흘림띠조종체를 추가하는것도 
시험해 볼수 있다. 



그림 6-2. 를림띠조종제 실례프로그람의 실행결과 


검 사 칸 


검사칸은 추가선택항목의 선택상태를 설정 혹은 비설정으로 하는데 사용되는 조종체 
이 다. 검 사칸은 작은 4 각형모양이 며 그 안에 검 사표식 을 표시하거 나 표시하지 않을수 
있다. 검사칸은 추가선택항목에 대해 설명하는 표식 ( Label ) 을 가지고 있다. 검사칸안에 
검사표식 이 있는 상태 를 검사된 상태 (설정 ) 라고 하며 해 당 항목이 선택 되 였 다는것 을 의 
미한다. 검사칸이 비여 있는 경우는 해 당 항목이 선택되여 있지 않다는것(비설정)을 의 
미 한다. 

검사칸은 대 화칸에서 사용되는 조종체이며 프로그람의 자원파일 에 서 대 화칸의 정의안 
에 추 가 된 다 . 대 화 칸 의 정 의 에 검 사 표 식 을 추 가 하 려 면 CHECKBOX 또 는 
AUTOCHECKBOX 중 한개의 명령문을 사용한다. 아래에 일반적인 서식을 보여 주었다. 
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CHECKBOX “ string ”, CBID , X , Y , Width , Height [, Style ] 

AUTOCHECKBOX “ string ”, CBID , X , Y , Width , Height [, Style ] 

string 은 검사칸과 함께 표시되는 문자렬 이 고 CBID 는 검사칸을 식별하기 위한 값 
이 다. 검사칸의 왼쪽웃모서 리의 자리표를 X , Y 에 설정하고 검사칸과 문자렬을 합친 크 
기를 Width 및 Height 에 설정한다. Style 에는 검사칸의 형식을 설정한다. 형식을 설정 
하지 않은 경우는 체계설정으로 검사칸의 오른쪽에 문자렬이 표시되며 검사칸이 건반입 
력초점을 받게 된다. 검사칸이 작성된 직후는 검사되여 있지 않는 상태로 된다. 

Windows 2000 을 다투어 보면 알수 있는것처 럼 검사칸의 상태는 반전절환타판사 변 
한다. 검사칸을 선택할 때마다 검사된 상태와 검사되지 않은 상태가 서로 바권다. 

이 조작은 필요에 따라 자동화할수 있 다. CHECKBOX 명령문을 사용하면 수동적 인 
검 사칸을 작성할수 있으며 프로그람코드로 검 사칸의 검 사상태 를 설정하게 된 다. (다시 말 
하여 수동 검사칸은 프로그람으로 조작하여 야 한다.) 

AUTOCHECKBOX 명령문을 사용하면 자동적 인 검 사칸을 작성 할수 있 으며 
Windows 2000 이 검사칸의 조작을 맡아 하도록 할수 있 다. 자동 검사칸은 그것 이 선택 
될 때마다 Windows 가 자동적으로 상태를 반전절환(검사상태의 설정/비설정)한다. 대 
다수의 응용프로그람에서는 검사칸을 수동으로 조작할 필요가 없으므로 앞으로 작성하게 
될 실례 프로그람에서 는 AUTOCHECKBOX 만을 사용하기 로 한다. 

검사칸의 상태를 얻기 

검사칸의 검사상태는 설정 혹은 비설정으로 되여 있다. SendDlgItemMessage() 라는 
API 함수를 리 용하여 검 사칸에 BM_GETCHECK 통보문을 보내 면 검 사칸의 상태 를 얻 을 
수 있다. 5장에서도 SendDlgltemMessageC ) 에 대 해 설명하였지만 아래 에 다시 한번 선 
언을 보여 주었다. 

LONG SendDlgltemMessage(HWND hdwnd , int ID , UINT IDMsg , 

WPARAM wParam , LPARAM lParam ); 


ID 에 대 화칸안의 조종체 를 식 별 하기 위 한 값을 설정 하고 IDMsg 에 통보문을 설정한 
다. hdwnd 에 대 화칸의 손잡이 를 설정 한다. BM_GETCHECK 를 보내 는 경 우에 는 
wParam 과 lParam 의 값을 령 으로 한다. 검 사칸이 검 사되 여 있 다면 BST—CHECKED 가 
돌려 지며 그렇지 않은 경우에는 BST—UNCHECKEDA 돌려 진다. 

검사칸에 검사표식을 붙이기 

프 로 그 람 에 서 검 사 칸 에 검 사 표 식 을 붙 일 수 있 다 . 그 러 자 면 API 함 수 
SendDlgltemMessage ( ) 를 리 용하여 BM_SETCHECK 통보문을 검 사칸에 보낸 다. 이 경 
우에는 wParam 에 검사칸의 상태를 설정으로 하겠는가 비설정으로 하겠는가를 설정한다. 
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wParam 이 BST—CHECKED 인 경 우 는 검 사 칸 의 상 태 가 설 정 으 로 된 다 . 
BST_UNCHECKED 인 경 우는 검 사칸의 상태 가 비 설 정 으로 된 다. 어 떤 경 우에 나 
IParam 에 는 령 을 설정 한다. 

이 미 설 명한것 처 럼 수동검 사칸에 서는 사용자의 조작에 응답하여 프로그람코드에 서 
검 사상태 를 변경 하여 야 한다. 그러 나 자동검 사칸을 사용하면 프로그람에 서 는 초기 상태 를 
설정해 주기만 하면 된다. 자동검사칸을 사용하는 경우에 그것이 선택될 때마다 상태가 
자동적으로 변화한다. 

작성 직 후의 검사칸의 상태는 비설정 (검사표식 이 불어 있지 않는 ) 으로 되 여 있다. 
그러므로 대화칸이 작성되였을 때의 검사칸의 상태는 비설정으로 된다. 

검사칸의 직전의 상태를 반영시키려면 대화칸이 작성될 때마다 초기화를 진행하여야 
한다. 그렇 게 하기 위한 가장 간단한 방법 은 대 화칸이 WM_INITDIALOG 통보문을 받았 
을 때 적절한 BM_SETCHECK 통보문을 검사칸에 보내는것 이 다. 

검사칸의 를보문 

사용자가 검 사칸을 찰칵하거 나 검 사칸을 선택한 다음 공백건을 누르면 
WM_COMMAND 통보문이 대화함수에 보내 여 진다. 이때 wParam 의 아래 단어 에는 검 
사칸을 식 별하는 값이 보관되며 wParam 의 웃단어 에 는 BN_CLICKED 라는 통지 문이 보 
관된다. 수동검사칸을 리용하는 경우에는 이 통보문에 대한 응답으로서 검사칸의 상태를 
변경하는 처 리를 해 야 한다. 


|다시 한보 전진| 


3상태검사칸 

Windows 2000 은 3상태검사칸이 라고 하는 검사칸도 제공한다. 이 검사칸은 
설정, 비설정 및 무효의 세개의 상태를 가지고 있다. (조종체가 회색으로 표시되 
여 있는 경우는 무효이다.) 

일반적 인 검사칸과 같이 3 상태검사칸은 AUT 03 STATE 또는 STATE 3 라 
는 자원파일 명 령 문을 리용하여 자동 혹은 수동조종체 로 할수 있 다. 아래 에 일 
반적인 서식을 보여 주었다. 

STATES “ string ”, ID , X , Y , Width , Height [, Style ] 

AUT 03 STATE “ string ", ID , X , Y , Width , Height [, Style ] 

string 은 검사칸과 함께 표시되는 문자렬 이 고 ID 는 검사칸을 식별하는 값이 
다. 검사칸의 왼쪽웃모서리의 자러표를 X , 구 에 설정하고 검사칸에 문자렬을 합 
친 크기를 Width 와 Height 에 설정한다. Style 에는 검사칸의 형식을 설정한 
다. 형식을 설정하지 않으면 체계설정으로 문자렬을 오른쪽에 표시하며 건반입력 
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초점을 가지게 된다. 3상태검사칸이 작성된 직후의 상태는 비설정으로 되 여 있다. 

BM_GETCHECK 통보문에 대 한 응답으로서 3 상태 검 사칸은 비 설정 상태 라면 
BST_UNCHECKED, 설 정 상 태 라 면 BST_CHECKED, 무 효 상 태 라 면 
BST_INDETERMINATE 를 돌려 준다. 

이와 마찬가지로 BM_SETCHECK 를 사용하여 3 상태검사칸의 상태를 설정 
하는 경 우에 는 BST_UNCHECKED 일 때 비 설정 상태 , BST_CHECKED 일 때 설 
정 상태 , BSTJNDETERMINATE 일 때 무효상태 로 된 다. 


단일선택단추 


다음에 설명할 조종체는 단일선택단추이다. 단일선택단추는 서로 상반되는 추가선택 
항목들을 선택 하는데 쓰인다. 단일선택단추는 표식과 작은 동그란 단추로 구성되 여 있다. 
단추가 ◦打 로 설정된 경우는 선택되여 있지 않다는것을 가리키며 단추가 On 으로 설정 
되여 있는 경우는 선택되여 있다는것을 가리킨다. 

Windows 2000 은 수동형과 자동형 의 두가지 형식의 단일선택단추를 제공한다. 수동 
단일선택단추에서는 수동검 사칸과 마찬가지 로 프로그람에 서 모든 조작을 진행 해 야 한다. 
자동단일선택단추에서는 이 조작이 자동화되 여 있다. 자동단일선택단추의 러 용이 압도적 
이므로 여 기 에서는 자동단일선택단추에 대 하여서 만 설명 하기 로 한다. 

다른 조종체와 같이 단일선택단추는 프로그람의 자원파일의 대화칸정의안에서 정의 
된 다. 자동 단일선택 단추를 작성 하기 위 하여 AUTORADIOBUTTON 명령문을 러 용한다. 
아래 에 일반적 인 구문을 보여 주었다. 

AUTORADIOBUTTON “string", RBID, X, Y, Width, Height!, Style] 

string 은 단추와 함께 표시 되 는 문자렬 이 고 RBID 는 단일선택단추를 식 별 하는 값이 
다. 단일선택단추의 왼쪽웃모서 리의 자리표를 X, Y 에 설정 하고 단추와 문자렬을 합한 
크기를 Width 와 Height 에 설정 한다. Style 에는 단일선택 단추의 형식을 설정 한다. 형 
식이 설정되지 않은 경우에는 체계설정으로 단추의 오른쪽에 문자렬을 표시하고 건반입 
력초점을 가지게 된다. 단추는 체계설정으로 설정상태로 되여 있다. 

이 미 설 명 한것 처 럼 단일선택 단추는 서 로 상반되 는 추가선택 항목들의 모임 을 만드는 
데 사용된다. 이 러한 모임을 만드는 경우에 자동단일선택단추를 사용하면 Windows 가 
한 단추만이 설정되도록 자동적으로 관리해 준다. 다시말하여 사용자가 한 단추를 선택 
하면 바로 전에 선택되여 있던 다른 단추의 상태가 비설정으로 된다. 사용자가 동시 에 
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여러개의 단추를 선택할수는 없다. 

단일선택 단추(자동단일선택 단추도 포함)의 상태는 프로그람에서 SendDlgltem 
Message ( )를 리 용하여 BM_ 況: TCHECKS 보문을: 보내서 설정 할수 있 다. 이 때 wParam 
에 는 단추의 설 정 혹은 비 설 정 상태 를 설 정 한다. wParam 에 BST_CHECKED 를 설정 하면 
단추의 상태 가 설정 으로 된다. BST_UNCHECKED 를 설정 하면 단추의 상태 는 비 설정 으 
로 된다. 체계설정으로는 모든 단추가 비설정으로 되여 있다. 

BM_GETCHECK 통보문을 보내 여 단일선택 단추의 상태 를 얻 을수 있 다. 단추가 설정 
된 상태 이 라면 BST_CHECKED 4 돌려 지 고 비 설정 상태 이 라면 BST_UNCHECKED 
돌려 진다. 

사용자가 단일선택단추를 조작하면 WM_COMMAND 통보문이 발송된 다. 수동단일 
선택단추를 사용하지 않는다면 보통 이 통보문에 응답할 필요는 없다. 

참고 : SendDlgltemMessage () 를 러용하면 한개이상의 단추를 설정상태로 하거나 모두 
비설정상태로 만들수도 있다. 그러나 일반적인 Windows 의 류의에서는 단일선택단추가 
서로 상반되는 항목을 선택하는데 사용되므로 하나의 항목만이 선택되도록 해야 한다. 
이 규칙을 지킬것을 강하게 권고한다. 


검사칸, 단일선택단추 및 를림띠의 실례프로그람 


이 절에서는 검사칸，단일선택단추 및 ■림띠와 실례를 보여 주기 위해 간단하면서도 
편리한 프로그람을 작성해 보기로 한다. 이 프로그람은 내려세기시계를 실현하는것이다. 

시계를 사용하기 위해 시간을 s 단위로 설정한다. 프로그람은 설정시간의 경과를 감 
시하다가 시간이 되였다는것을 알려 준다. 이 내려세기시계에서는 시간의 설정을 흘림 
띠 로 진행 한다. 검사칸과 단일선택단추는 시 간이 경과했을 때 경보음을 울리겠는가 울리 
지 않겠는가 등 여러가지 추가선택항목들을 설정하는데 리용된다. 

프로그람을 작성하기에 앞서 Windows 2000 의 기능의 하나인 시계에 대해 배워 두 
자. 내려세기시계프로그람에서는 시간의 경과를 검사하기 위하여 Windows 에 미리 갖 
추어 진 시계를 한개 사용한다. 

시계를보문의 생성 

Windows 2000 에서는 일정한 시간간격으로 프로그람에 새치기를 거는 시계를 작성 
할수 있다. 지정된 시간간격으로 Windows 2000은 프로그람에 WM _ TIMER 통보문을 보 
낸다. 시계는 특히 과제를 배경에서 실행시킬 때 편리하다. 

시 계를 기동하자면 SetTimerC M 는 API 함수를 사용한다. 선언은 다음과 같다. 
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UINT SetTimer(HWND hwnd , UINT nID , UINT wLength , 

TIMERPROC lpTFunc ) : 

hwnd 는 시계를 사용하는 창문의 손잡이 이다. 일반적으로 이 창문은 프로그람의 기 
본창문이거나 대화칸의 창문이다. nID 에는 시계를 식별하는 값을 설정한다. (여러개의 
시계를 사용하는 경우에는 식별이 필요하다.) wLength 에는 ms 단위로 시간간격을 설정 
한다. 다시말하여 wLength 가 새 치기 하는 시 간간격을 결정 한다. 

lpTFunc 에 설정되는 함수의 지시자는 시계의 시간이 경과했을 때 호출되는 시계함 
수이 다. 그러 나 lpTFunc 에 NULL 을 설정하면 hwnd 에 설정된 창문의 창문함수가 호 
출되게 되므로 자체의 시계함수를 준비할 필요는 없다. 이 경우에는 시계의 시간이 경과 
하면 프로그람의 통보문대기렬에 WM _ TIMER 가 보관되며 다른 통보문과 꼭같이 처러할 
수 있다. 

뒤에서 보게 될 실례프로그람에서는 이 수법 이 사용된다. SetTimerC ) 함수의 호출이 
성공하면 nID 의 값이 돌려 진다. 시계가 할당되지 않은 경우는 령이 돌려 진다. 

독자의 시계함수를 작성 하려는 경우에는 그것을 아래 에서 보여 주는 선언과 같이 으/ 
호출함수로사 작성하여 야 한다. (물론 함수의 이름은 임의로 하여도 상관 없다.) 

VOID CALLBACK Tfunc(HWND hwnd , UINT msg , UINT TimerlD , 

DWORD SysTime ) : 

hwnd 에는 시계를 사용하는 창문의 손잡이가, msg 에는 WM_TIMER 통보문， 
TimerlD 에는 시계를 식 별하는 값， sysTime 에는 현재 체계시 간이 보관된다. 

시계 가 일단 기동되면 응용프로그람을 끝내든가 프로그람이 KiIlTimer ( ) 라는 API 함 
수를 호출할 때까지 시계의 새치기가 계속된다. KlUTimerC ) 악 선언은 다음과 같다. 


BOOL KillTimerCHWND hwnd , UINT nID ) ； 


hwnd 는 시계를 사용하는 창문의 손잡이이며 nID 는 시계를 식별하는 값이 다. 함수 
의 호출이 성공하면 령 아닌 값을 돌려 지며 실패하면 령이 돌려 진다. 

WMJTIMER 통보문이 생성되였을 때 wParam 에는 시계의 ID 가 보관되고 IParam 
에는 만일 존재 한다면 시계의 역호출함수의 주소가 보관된다. 내 려세기시계프로그람에서 
IParam 은 NULL 로 된다. 


내려세기시계프로그람의 자원과일과 머리 부 파일 


내 려세기시계프로그람은 아래와 같은 자원파일을 사용한다. 
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// 흘림띠,검사칸 및 단일선택단추의 실례 
ttinclude〈windows. h> 

^include "cd.h” 

MyMenu MENU 

{ 

POPUP ，，技 Dialog" 

{ 

MENUITEM ’，&Timer\tF2”, IDM.DIALOG 
MENUITEM n &Exit\tF3 H , IDM.EXIT 

} 

MENUITEM "&Help M , IDM.HELP 

} 

MyMenu ACCELERATORS 

{ 

VK_F2, IDM.DIALOG, VIRTKEY 
VK_F3, IDM.EXIT, VIRTKEY 
VK_F1, IDM_HELP, VIRTKEY 

} 

MyDB DIALOGEX 18, 18, 152, 92 
CAPTION M A Countdown Timer" 

STYLE DS_MODALFRAME | WS_POPUP | WS.CAPTION | WS.SYSMENU 
| WS.VSCROLL 

{ 

PUSHBUTTON ” Start", IDD.START, 10, 60, 30, 14 
PUSHBUTTON ” Cancel", IDCANCEL, 60, 60, 30, 14 
AUTOCHECKBOX "Show Countdown", IDD.CBl, 1, 20, 70, 10 
AUTOCHECKBOX "Beep At End", IDD_CB2, 1, 30, 60, 10 
AUTORADIOBUTTON "Minimize”, IDD.RB1, 80, 20, 50, 10 
AUTORADIOBUTTON "Maximize”, IDD.RB2, 80, 30, 50, 10 
AUTORADIOBUTTON "As_Is”, IDD.RB3, 80, 40, 50, 10 

} 

내려세기시계프로그람에서 사용되는 머리부파일을 아래에 보여 주었다. 이 파일을 
CD.H 라는 파일 이 름으로 작성 해 둔다. 

♦define IDM_DIALOG 100 

#define IDM_EXIT 101 
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#define IDM.HELP 102 

#define IDD_START 300 

ttdefine IDD—TIMER 301 

#define IDD_CB1 400 

ttdefine IDD_CB2 401 

#define IDD 一 RBI 402 

#define IDD.RB2 403 

ttdefine IDD_RB3 404 


내려세기시계의 프로그람코드 

내 려 세 기 시 계 프로그람의 완전한 프로그람코드를 실 례 6-3 에 주었 다. 

실 례 6-3. Cd 프로그람 

// 내려세기시계 

ttinclude 〈 windows. h> 
ttinclude <cstring> 

^include <cstdio> 
ttinclude "cd.h" 

ttdefine VERTRANGEMAX 200 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
BOOL CALLBACK DialogFunc(HWND, UINT, WPARAM, LPARAM) ； 

char szWinName [] = ” MyWin”; // 창문들라스의 이름 
HINSTANCE hlnst ； 

HWND hwnd ； 

int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 

// 창문믈라스를 정의 한다 . 
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wcl. cbSize = sizeof (WNDCLASSEX) ; 

wcl.Mnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문콜라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) : // 큰 아이콘 
wcl. hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

// 차림표자원의 이름을 지정한다 . 
wcl. IpszMenuName = "MyMenu" : 

wcl. cbClsExtra = 0; // 보조기 억기령 역은 불필 요함 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색은 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) : 

// 창문콜라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Demonstrating Controls", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결 정 하게 한다 . 
CWJJSEDEFAULT, // 창문의 너 비는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 

NULL, // 어미창문은 없다 . 

NULL, // 콜라스차림 표의 덧쓰기는 하지 않는다 . 

hThisInst, // 실체의 손잡이 

NULL // 추가파라메 터 는 없 다 . 

)； 

hlnst = hThisInst; // 현재 실체의 손잡이를 보관한다 . 
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hAccel = LoadAccelerators (hThisInst, "MyMenu”); 

// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) ； 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

if(! TranslateAccelerator (hwnd, hAccel, &msg)) { 
TranslateMessage(&msg) ； // 건반통보률 변환한다 . 

DispatchMessage (技 msg) ; // Windows 2000 에 조종을 넘 긴다 . 

} 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받는다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

int response; 

switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM_DIALOG: 

DialogBox(hInst, n MyDB", hwnd, (DLGPROC) DialogFunc) ； 
break ； 

case IDM_EXIT ： 

response = MessageBox(hwnd, "Quit the Program?", 

” Exit”, MB 一 YESNO); 
if (response == ID YES) PostQuitMessage(O) ； 
break ； 

case IDM_HELP ： 

MessageBox (hwnd, "Try the Timer", "Help", MB_OK) ； 
break ； 
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} 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ; 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 이 처 리 하게 한다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam); 

} 

return 0 ； 

} 

// 대화함수 

BOOL CALLBACK DialogFunc (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

char str[80] ； 

static int vpos = 0 ； // 수직흘림칸의 위 치 

static SCROLLINFO si ； // 흘림띠정보를 보관하는 구조체 

HDC hdc ； 

PAINTSTRUCT paintstruct; 


static int t ； 


switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDCANCEL ： 

EndDialog (hdwnd, 0); 
return 1 ； 

case IDD.START: // 시계를 기동한다 . 

SetTimer(hdwnd, IDD 一 TIMER, 1000, NULL )； 
t = vpos ； 

if (SendDlgltemMessage (hdwnd, 

IDD.RB1, BM_GETCHECK, 0, 0) == BST.CHECKED) 
ShowWindow(hwnd, SW.MINIMIZE) ； 
else 

if (SendDlgltemMessage (hdwnd, 
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IDD.RB2, BM.GETCHECK, 0, 0) == BST 一 CHECKED) 

ShowWindow (hwnd, SW.MAXIMIZE) ； 
return 1 ； 

} 

break ； 

case WM.TIMER ： // 시계의 시간이 경과했다 . 
if (t==0) { 

KillTimer(hdwnd, IDD_TIMER); 
if (SendDlgltemMessage (hdwnd, 

IDD_CB2, BM.GETCHECK, 0, 0) == BST.CHECKED) 

MessageBeep (MB_OK) ； 

else MessageBox(hdwnd, "Timer Went Off’, ” Timer”, MB_OK) ； 
ShowWindow (hwnd, SW.RESTORE) ； 
return 1 ； 

} 

t —； 

// 내려세기률 표시할것인가를 확인한다 . 
if (SendDlgltemMessage (hdwnd, 

IDD.CBl, BM.GETCHECK, 0, 0) == BST.CHECKED) { 
hdc = GetDC(hdwnd) ； 
sprintf(str, ’’Counting: %d ", t) ； 

TextOut(hdc, 1, 1, str, strlen(str)) ； 

ReleaseDC(hdwnd, hdc); 

} 

return 1 ； 

case WMJNITDIALOG ： 
si.cbSize = sizeof (SCROLLINFO) ； 
si.fMask = SIF_RANGE ； 
si.nMin = 0 ； si.nMax = VERTRANGEMAX ； 

SetScrollInfo (hdwnd, SB_VERT, &si, 1); 

// 「 As-Is 」 단일선택단추를 확인한다 . 

SendDlgltemMessage (hdwnd, IDD_RB3, BM.SETCHECK, BST.CHECKED, 0 )； 
return 1 ； 
case ■ 一 PAINT: 

hdc = BeginPaint (hdwnd, &paintstruct) ； 
sprintf(str, "Interval ： %d”, vpos); 

TextOut(hdc, 1, 1, str, strlen(str)) ； 
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EndPaint (hdwnd, &paintstruct) ； 


return 1 ； 


case WM.VSCROLL ： 
switch (LOWORD (wParam)) { 
case SB.LINEDOWN ： 
vpos ++； 

if (vpos»VERTRANGEMAX) vpos = VERTRANGEMAX ； 
break ； 

case SB.LINEUP ： 
vpos —； 

if(vpos<0) vpos = 0 ； 
break ； 

case SB.THUMBPOSITION : 
vpos = HIWORD(wParam) ； // 현재위치를 엄는다 . 
break ； 

case SB—THUMBTRACK: 
vpos = HIWORD (wParam) ； // 현재위치 률 얻 는다 . 
break ； 

case SB_PAGEDOWN ： 
vpos += 5 ； 

if(vpos»VERTRANGEMAX) vpos = VERTRANGEMAX ； 
break ； 

case SB_PAGEUP: 
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if(vpos<0) vpos = 0 ； 

} 

si. f Mask = SIF.POS ； 
si.nPos = vpos; 

SetScrollInfo(hdwnd, SB_VERT, &si, 1); 
hdc = GetDC(hdwnd) ； 
sprintf(str, "Interval ： %d ", vpos); 
TextOut(hdc, 1, 1, str, strlen(str)) ； 
ReleaseDC (hdwnd, hdc) ； 
return 1 ； 

} 

return 0 ； 

} 

프로그람의 실행결과를 그림 6-3 에 보여 주었다. 



그림 6-3. 내려세기 시계프로그람의 실행 결과 
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내려세기시계프로그람의 상세 


내 려세기시계프로그람에서 사용되는 조종체들이 어떻게 조작되 는가를 보자. 

수직흘림띠는 시간간격을 설정하는데 사용되고 있다. 홀림띠의 상태를 검사하는 부 
분에서 는 앞에서 설명 한것과 같은 프로그람코드가 사용되 므로 더 설명할 필요가 없 다. 
그러 나 검사칸과 단일선택단추를 조작하는 프로그람코드는 자세 히 볼 필요가 있다. 

이 미 설명한바와 같이 작성된 직 후에 는 어 느 단일선택단추도 설정 되 여 있지 않다. 
그러므로 대화칸이 작성되였을 때 프로그람에서 어느 하나를 설정해 주어야 한다. 이 실 
례프로그람에서는 WM_INITDIALOG 통보문이 전송될 때마다 아래의 프로그람코드를 사 
용하여 [ As - Is ] 단일 선택단추 ( IDD _ RB 3) 를 설 정한다. 

SendDlgltemMessage ( hdwnd , IDD _ RB 3, BM _ SETCHECK , 

BST _ CHECKED , 0); 

시계를 기동하기 위하여 사용자는 [ Start ] 단추를 누른다. 이것은 아래의 프로그람코 
드로 실행된다. 

case IDD_START: // 시계를 기동한다 . 

SetTimer(hdwnd, IDD_TIMER, 1000, NULL); 
t = vpos; 

if (SendDlgltemMessage (hdwnd, 

IDD.RB1, BM_GETCHECK, 0, 0) == BST_CHECKED) 

ShowWindow (hwnd, SW—MINIMIZE); 
else 

if (SendDlgltemMessage (hdwnd, 

IDD_RB2, BM_GETCHECK, 0, 0) == BST_CHECKED) 

ShowWindow (hwnd, SW_MAXIMIZE) ； 
return 1 ； 


시계의 시간은 is(iooo jb ) 로 설정되였다. 계수기로 되는 변수 t 에는 수직흘림띠의 
위 치 값이 설정된다. [ Minimize ] 단일선택단추가 설정된 경 우는 프로그람창문이 최 소화 
된다. [ Maximize ] 단일선택단추가 설정된 경우는 프로그람창문이 최 대 화된다. 그밖의 경 
우에 프로그람의 창문크기는 변하지 않는다. 

대 화칸의 손잡이 hdwnd 가 아니 라 기 본창문의 손잡이 hwnd 를 지 정 하여 
ShowWindow ( )를 호출한다는점 에 주목해 야 한다. 프로그람을 최소화 또는 최대화하 
는데는 대화칸의 손잡이가 아니라 기본창문의 손잡이가 사용된다. 

또한 이 프로그람에서 hdwnd 가 대역변수로 선언되여 있는 점에도 주목해야 한다. 
이렇게 하여 DialogFunc ( ) 에서 hdwnd 을 사용할수 있다. 

WMJTIMER 통보문을 받을 때 마다 아래의 프로그람코드가 실행된다. 
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case WM_TIMER ： // 시간이 경과했다 . 
if(t==0) { 

KillTimer(hdwnd, IDD—TIMER); 
if (SendDlgltemMessage (hdwnd, 

IDD_CB2, BM_GETCHECK, 0, 0) == BST_CHECKED) 
MessageBeep (MB_OK) ； 

else MessageBox(hdwnd, "Timer Went Off”, "Timer”, MB_OK); 
ShowWindow (hwnd, SW.RESTORE) ； 
return 1 ； 

} 


// 내려세기를 표시할것인가를 검사한다 . 
if (SendDlgltemMessage (hdwnd, 

IDD—CB1, BM.GETCHECK, 0, 0) == BST_CHECKED) { 
hdc = GetDC(hdwnd) ； 
sprintf(str, "Counting ： %d ", t) ； 

TextOut(hdc, 1, 1, str, strlen(str)) ； 

ReleaseDC (hdwnd, hdc) ； 

} 

return 1 ； 

내려세기가 령에 도달하면 시계가 정지되고 필요에 따라 창문이 본래의 크기로 돌아 
간다. [Beep At End ] 단추가 설정 되 면 MessageBeep ( ) 라는 API 함수를 사용하여 를퓨 
터의 고성기가 경보음을 내게 된다. 그렇지 않은 경우에는 통보칸이 표시된다. 설정시간 
에 도달하지 않은 경 우에 는 계 수기 인 변수 t 가 감소된 다. [Show Countdown ] 단추가 
설정되면 남은 시간이 표시된다. 

MessageBeep ( ) 의 선언은 다음과 같다. 


BOOL MessageBeep(UINT sound ); 

sound 에 는 소리의 종류를 설정 한다. 이 값을 -1 로 하면 표준적 인 경 보음이 울리며 
아래의 값을 설정할수도 있다. 

MBJCONASTERISK MBICONEXCLAMATION MB_OK 

MBJCONHAND MBJCONQUESTION 

MB — OK 도 표준적 인 경보음이 울리게 한다. 호출이 성공하면 MessageBeep ( ) 는 령 
아닌 값을 돌려 주며 실패하면 령 을 돌려 준다. 

내려세기시계프로그람을 통해 알수 있는바와 같이 자동검사칸과 단일선택단추는 대 
체 로 Window 2000에 의 해 조작되 므로 그 조종체 들을 처 리 하기 위 한 프로그람코드는 놀 
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라울 정도로 작다. 사용방법 이 간단하다는것으로 하여 검사칸이나 단일선택단추는 많은 
상황에서 사용된다. 


정 적 조종체 


표준적 인 조종체 들가운데 서 가장 간단하게 사용되 는것 은 정 적조종체 이 다. 정적조종 
제는 통보문을 생성하지도 않으며 받지도 않는다. 다시말하여 정적조종체의 역할이 란 대 
화칸에 어떤 요소를 표시하는것뿐이다. 

정 적 조종체 에 는 정 적 본문으로 되 는 CTEXT, RTEXT, LTEXT 장 조종체 를 집 합으 
로 묶는데 사용되는 GROUPBOXA 있다. 

조종체는 지정된 령역의 중심 에 맞추어 문자렬을 표시한다. LTEXT 는 문자 
렬 을 왼쪽맞추기 하여 표시 한다. RTEXT 는 문자렬 을 오른쪽맞추기 하여 표시 한다. 이 조 
종체들의 일반적인 서식을 아래에 보여 주었다. 

CTEXT “ texf ，， ID , X ， Y , Width , Height [, Style ] 

及 TEXT “ text ”, ID , X ， Y , Width , Height [, Style ] 

LTEXT “ text ”, ID , X , Y , Width , Height [, Style ] 

text 에 는 표시할 문자렬을 설정 한다. ID 에 는 문자렬 을 식 별 하기 위한 값을 설정 한 
다. 표시 되 는 문자렬의 왼쪽웃모서 리 의 자러표를 X , Y 에 설정 하고 크기 를 Width 와 
Height 에 설정 한다. Style 에 는 조종체 의 형 식을 설정 한다. 일 반적 으로는 체계 설정의 형 
식을 사용한다. 

문자렬 을 둘러 싸는 4 각형 은 표시 되 지 않는다. X , Y , Width 및 Height 는 문자렬 
이 점유하는 령역을 지정하기 위한 목적으로만 리용된다. 

정 적본문은 대 화칸에 문자렬 을 표시할 때 편 리하게 쓰인 다. 정 적본문은 대 화칸 
안의 다른 조종체의 표식 으로서 사용되 거 나 사용자에 게 간단한 설명 을 표시하는데 
잘 사용된다. 

집 합칸은 대화칸안의 조종체들을 둘러 싸고 그것들을 집합하는데 사용된다. 또한 집 
합칸은 제목을 표시할수 있다. GROUPBOXA 일반적 인 구문은 아래와 같이 되여 있다. 

GROUPBOX " title ", ID , X , Y , Width , Height [, Style ] 

title 에 는 집 합칸의 제 목을 설정 한다. ID 에 는 집 합칸을 식 별 하는 값을 설정 한다. 집 
합칸의 왼쪽웃모서리의 자리표를 X , Y 에 설정하고 크기를 Width 와 Height 에 설정한 
다. Style 에 는 집 합칸의 형 식 을 설정 한다. 

일반적으로는 체계설정의 형식이 사용된다. 

집합칸의 기능을 확인하기 위하여 내려세기시계프로그람의 자원파일에 아래의 정의 
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를 추가한다. 

GROUPBOX “Display As ”, 1，72, 10, 60, 46 

집 합칸을 추가하면 대 화칸은 그림 6-4 와 같이 된다. 집 합칸을 사용하여 대화칸의 
외형을 변경시켜도 프로그람의 기능은 변하지 않는다. 



|다시 한보 전진| 


단독의 조종 제 

조종체 는 대 화칸안에 서 사용되 는것 이 일 반적 이 지 만 기 본창문안에 서 단독으 
로 리용할수도 있다. 이러한 독자적인 조종체를 작성하려면 CreateWindow ( ) 
를 사용하여 목적하는 조종체의 클라스이름과 형식을 지정한다. 

아래에 표준적인 조종체들의 클라스이름을 보여 주었다. 

BUTTON 

COMBOBOX 

EDIT 

LISTBOX 

SCROLLBAR 

STATIC 

매개 클라스에는 조종체의 형식을 설정하기 위한 마크로가 있다. 이 마크로들 
에 대한 자세한 설명을 얻으러면 WINDOW.H 또는 API 참고서를 보면 된다. 

아래 의 프로그람코드는 독자적 인 흘림띠 와 누름단추를 작성하는것 이 다. 

hsbwnd = CreateWindowC 

“SCROLLBAR”, // 흘림띠의 둘라스이름 
“”, // 제목이 없다 . 

SBS_HORZ | WS_CHILD | WS_VISIBLE, // 수평흘림 띠 
_ 10, 10,_ //위치 _ 


교육성 프로그람교육뺀터 


189 













Windows 2000 프로그람작성 법 


120, 20, 

// 크기 


hwnd, 

// 어미창문 


NULL, 

// 흘림띠에는 조종체를 식별하는 값이 필요 없다 . 

hThisInst, 

// 프로그람의 실체손잡이 


NULL 

); 

// 추가하는 파라메 터는 없다 . 


hpbwnd = CreateWindow( 



“BUTTON”, 

// 누름단추의 를라스이 름 


“Push Button”, 

// 단추의 내부에 표시되는 문자렬 


BS_PUSHBUTTON | WS_CHI1D | WS_VISIBLE, // 누름단추 


10, 60, 

// 위 치 


90, 30, 

// 크기 


hwnd, 

// 어미창문 


(HMENU) 500, 

// 조종체를 식별하는 값 


hThisInst, 

// 프로그람의 실체손잡이 


NULL 

)： 

// 추가하는 파라메 터는 없다 . 


누름단추의 작성에서는 그것을 식별하는 값이 CreateWindows ( ) 의 

9 개의 

파라메터의 하나로서 설정되여 

있 다. 이 파라메터 에 클라스차림 표를 덧 쓰기할 

때 차림표의 손잡이를 설정하였다는것을 상기해 볼 필요가 있다. 조종체를 작 

성할 때는 이 파라메터에 조종체를 식별하는 값을 설정한다. 


이 파라메터 는 HMENU 형 으로 형변환하여 야 한다. 


독자적 인 조종체 가 생성한 통보문은 그의 어 미창문에 전달된다. 이 

통보문 

을 처 리하는 프로그람코드는 어 미창문의 창문함수에 서 술한다. 
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비트매프의 사용법과 
다시그리기 문제의 해결방법 

비트매프란 화상을 포함한 객체를 말한다. 이 말은 비트매프가 화상을 
정 의 하는 비 트들의 모임 이 라는데 서 유래 된것 이 다. Windows 는 도형 에 기 
초한 조작체계이므로 응용프로그람의 자원으로서 도형을 리용하는것이 보 
편적이다. 

그러 나 단지 자원파일 에 도형 을 포함시키 는것 만으로 그것 을 응용프로 
그람에서 사용할수 있는것은 아니 다. 도형은 Windows 의 사용자대면부를 
조작하는 여 러가지 기능들의 우에 성립되여 있다. 

이 장에서는 Windows 프로그람을 작성할 때 《창문의 다시그리기》를 
해결하는 방법에 대해서도 취급한다. 

Windows 에는 아이콘과 유표라는 특수한 비트매프도 있다. 아이콘은 
어 떤 자원 혹은 객체를 가리키며 유표는 마우스의 현재위 치를 가리킨다. 
지금까지는 미 리 갖추어진 아이콘과 유표만을 사용할수 있었다. 이 장에서 
는 전용아이콘이나 전용유표를 작성하는 방법에 대해서도 설명한다. 
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비트매프의 두가지 종류 


Windows 2000 이 지원 하는 비트매프야는 장치의존비트매프 iDDB ) 와 장치독립비트매 
프 CD / 谷)의 두가지 종류가 있 다. 장치의 존비 트매 프는 특정한 장치용으로 설 계된 비 트매 
프이 다. 장치 독립비 트매 프는 특정 한 장치 에 의 존하지 않는다. 

초기의 Windows 에서는 장치의존비트매프만을 취급할수 있었다. Windows 3.0 이후 
의 모든 판본의 Windows 에서는 장치독립 비트매프도 사용할수 있게 되 여 있다. 

장치독립비 트매 프는 비 트매 프가 작성 된 장치 이외 의 환경 에 서 비 트매 프를 취 급하는 
경우에 유용하다. 실례 로 비 트매 프를 배 포하는 경우에 는 그것 을 장치 독립비트매 프로 하 
는것이 최량의 방법이다. 그러나 특정한 프로그람내에서만 사용되는 비트매프라면 장치 
의 존비 트매 프라고 해 도 충분하다. 이 런 리 유로 지 금까지 도 장치 의 존비 트매 프가 광범히 
사용되고 있다. Win 32 는 필요에 따라 DDB 와 DIB 를 변환하는 몇개의 함수를 제공하고 
있 다. 

DDB 와 DIB 의 구조는 서로 다르다. 그러 나 이 장에서는 그러한 차이 가 중요하지 
않다. 사실 응용프로그람의 외형을 설정할 때 비트매프의 2 진형식을 의식하는 일은 거 
의 나 없 다. Windows 가 비 트매 프를 조작하기 위 한 고급한 기 능의 API 함수를 제 공하여 
주므로 프로그람작성자는 비트매프의 내부적 인 구조를 알 필요는 없다. 

이 장에서는 비트매프를 작성 한 프로그람에서 그 비트매프를 사용하므로 장치의존비 
트매프를 사용하기 로 한다. 

비트매프를 취급하는 두가지 방법 


비트매프는 자원에 정의하는 방법과 프로그람내 에서 동적으로 작성 하는 방법의 두가 
지 방법 으로 엄 을수 있 다. 첫 번째 방법 에 서 비트매프자원아탄: 프로그람의 외부에서 정 의 
된 화상을 프로그람의 자원파일로 지정한것 이 다. 두번째 방법의 동적 비트매 프란 실행시 
에 프로그람에 의해 작성되는것 이 다. 이 장에서는 두가지 방법을 다 설명한다. 비트매프 
자원에 대 한 설명 으로부터 시 작한다. 

비트매프자원의 사용방법 


비트매프자원을 사용하기 위한 일반적 인 순서는 다음과 같다. 
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• 프로그람의 자원 파일 에 비 트매 프를 지 정한다. 

• 프로그람에 서 비 트매 프를 적 재한다. 

• 장치 상황에 비 트매 프를 선 택한다. 

다음 절에서는 이러한 단계를 실현하는 방법을 설명한다. 

비트매프자원의 작성 

비 트매 프자원은 앞의 장들에서 설명한 대 화칸 및 조종체 등의 자원과는 다르다. 지 
금까지 설명 한 자원들은 자원파일 안에 본문 명 령 문으로 정 의하였 다. 이 와는 달리 비 트매 
프자원은 독립적 인 비트매프파일에 보관된 화상으로 되여 있다. 프로그람의 자원파일에 
는 비트매프파일에 대 한 참조를 정의한다. 

비 트매 프자원은 임의의 화상편집기를 리용하여 작성된다. 화상편집기는 번역프로그 
탐에 첨 부되 여 있 다. 화상편집 기 로는 비 트매 프를 확대 하여 표시할수도 있 다. 화상편집 기 
를 사용하면 비트매프의 작성 이 나 편집을 손 쉽게 할수 있다. 실례 로 Visual C ++ 의 화상 
편집기에서 비트매프를 표시한 모양을 그림 7-1 에 보여 주었다. 

아이콘이나 유표 등의 특수한 비트매프를 제외하고는 크기를 임의로 할수 있다. 뒤 
에서 작성하게 되는 실례프로그람에서 비트매프의 크기는 256 / 128 화소로 되 여 있다. 
이 비 트매 프파일 을 BP.BMP 라는 파일 이 름으로 작성한다. 

이 장에서 작성 하는 실례 프로그람에서는 그림 7-1 에 보여 준것과 같은 비트매프를 사 
용한다. 비 트매 프를 작성 하고 다음의 행 을 포함하는 BP.RC 라는 자원파일 을 작성 한다. 

MyBP BITMAP BP. BMP 



그림 7-1. Visual C ++ 의 화상편집기 
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우의 행에서 公/ T/IMP 身량문은 BP.BMP 파일에 보관된 비트매프자원에 MyBP 라는 
이름을 붙여 정의하고 있다. 아래에 BITMAP 명령문의 일반적인 서식을 보여 주었다. 

BitmapName BITMAP Filename 

BitmapName 은 비트매프를 식별하는 이름이 다. 이 이름은 프로그람에서 비트매프 
를 참조할 때 사용된다. Filename 은 비트매프가 보관된 파일의 이름이 다. 

비트매프의 표시 

비 트매 프를 작성 하고 프로그람의 자원파일 에 정 의하였 다면 그것 을 창문의 의 뢰 자구 
역에 표시할수 있다. 그를 위한 프로그람코드를 써 넣어야 한다. 여기에서는 비트매프를 
표시 하는 방법을 설명 한다. 

비트매프를 표시하려면 먼저 비트매프를 적재하고 그의 손잡이를 얻어야 한다. 이 
처 리는 WinMainC ) 내에서 또는 응용프로그람의 기본창문이 1찌 C 次요소: T 표 통보문을 받 
을 때 진행한다. WM_CREATE 통보문은 창문(혹은 그와 관련된 요소)에 대 해 어떤 초 
기화처리를 진행하기 위한 절호의 시점이다. 

기 본창문의 의 뢰 자구역 에 비 트매 프자원을 표시 하려 면 기 본창문이 WM_CREATE 통보 
문을 받을 때 비트매프의 적재를 진행해야 한다. 여기에서는 이 수법을 적용하기로 한다. 

비 트매 프를 적 재 하는 가장 간단한 방법 은 LoadBitmai }( ) 과는 API 함수를 사용하는 
것이다. 아래에 선언을 보여 주었다. 


HBITMAP LoadBitmap (HINSTANCE hThisInst , LPCSTR IpszName ) : 


hThisInst 에는 실체의 손잡이를 설정하고 자원파일에 정의되여 있는 비트매프의 이 
름을 IpszName 에 설정한다. 이 함수는 비트매프의 손잡이를 돌려 주며 오유가 발생한 
경우는 NULL 을 돌려 준다. 아래에 실례를 보여 주었다. 


HBITMAP hbit ； // 비트매프의 손잡이 

// ... 

hbit = LoadBitmap(hlnst, “MyBP”); // 비트매프를 적재한다 . 

이 프로그람코드는 MyBP 라는 이 름의 비 트매 프를 적 재 하고 그의 손잡이 를 hbit 에 보 
관한다. 비트매프를 표시 할 시점 으로 되면 프로그람은 아래의 순서로 처 리를 진행한다. 


• 창문에 출력 을 진행 하기 위한 장치 상황을 얻 는다. 

• 표시할 비 트매 프를 보관해 두기 위 해 창문의 장치 상황과 호환성 있는 기억기장 
치상 m 울 엄는다. (비트매 프는 창문에 복사되기전에 기 억기 에 보관된다.) 
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• 기 억 기 장치 상황에 비 트매 프를 선택한다. 

• 기 억기 장치상황으로부터 창문의 장치상황에 비 트매 프를 복사한다. 

이 4 개의 처 리를 실행하는 프로그람코드를 다음에 보여 주었다. 여기 에서는 
WM _ PAINT 통보문을 받았을 때 창문의 다른 위치에 두개의 비트매프를 표시하고 있다. 

HDC hdc, memdc ； 

PAINTSTRUCT ps ； 


II... 

case WM_PAINT ： 

hdc = BeginPaint (hwnd, &ps); // 장치 상황을 얻 는다 . 

memdc = CreateCompatibleDC(hdc) : //호환성 있는 장치 상황을 작성 한다 . 
SelectObject(memdc, hbit) ; //비 트매 프를 선택 한다 . 


BitBlt(hdc, 10, 10, 256, 128, 

memdc, 0, 0, SRCCOPY); // 화상을 표시한다 . 

BitBltChdc, 300, 100, 256, 128, 

memdc, 0, 0, SRCCOPY); // 화상을 표시 한다 . 

EndPaint (hwnd, &ps) ; // 장치 상황을 해 제 한다 . 

DeleteDC(memdc) ; // 기 억기장치상황을 해제 한다 . 

break ； 

이 프로그람코드의 내 용을 차례 로 설명해 보자. 

우선 두개의 장치상황악 손잡이가 선언되고 있다. hdc 에는 BeginPaint ( ) 에서 얻은 
창문의 장치상황이 설정된다. memdc 에는 창문에 그려질 때까지 비트매프를 보관해 두 
는 기억기장치상황이 설정된다. 

WM_PAINT 의 case 문에서 창문의 장치상황이 얻 어 진다. 이것 이 필요한 리 유는 
장치상황을 얻지 않으면 창문의 의뢰자구역에 비트매프를 그릴수 없기때문이다. 

다음 비트매프를 보관해 두는 기억기장치상황아 작성된다. 이 기 억기장치상황은 창문 
의 장치상황과 호환성 있는것이여야 한다. 호환성 있는 기억기장치상황은 
CreateCompatibleDC ( M 는 API 함수를 사용하여 작성 된다. 아래 에 선언을 보여 주었 다. 


HDC CreateCompatibleDC (HDC hdc ) : 
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이 함수는 hdc 에 지정된 창문의 장치상황과 호환성 있는 기억기장치상황을 작성하 
고 그의 손잡이를 돌려 준다. 이 기억기는 표시되기전의 화상을 보관할 때 사용된다. 오 
유가 발생한 경우에 함수의 돌림값은 NULL 로 된다. 

다음 SelectObject ( M 는 API 함수를 사용하여 비 트매 프를 기 억 기 장치 상황에 선택 한 
다. 아래에 선언을 보여 주었다. 


HGDIOBJ SelectObject(HDC hdc , HGDIOBJ hObject ) ; 


hdc 에는 장치상황을 설정하고 hObject 에는 장치상황에 선택하는 객체의 손잡이를 
설정한다. 이 함수는 (만일 존재한다면) 바로 전에 선택되여 있었던 객체의 손잡이를 돌 
려 주므로 펼요하다면 후에 본래의 상태로 돌아갈수도 있다. 

실제 로 비 트매 프를 표시 하는데 는 BitBlt ( M 는 API 함수를 사용한다. 이 함수는 한 
장치상황으로부터 다른 장치상황에 비트매프를 복사한다. 아래에 선언을 보여 주었다. 

BOOL BitBlt(HDC hDest , int X , int Y , int Width , int Height , 

HDC hSource , int SourceX , int SourceY , DWORD dwHow ); 


比 Dest 에는 복사측의 장치상황을 설정하고 X 및 Y 에는 비트매프를 그리는 자리표 
를 설정한다. 복사측의 령역의 너비와 높이는 Width 및 Height 에 설정한다. hSource 
에는 복사원천으로 되는 장치상황의 손잡이를 설정한다. 여기에서는 이것이 
CreateCompatibleDCC ) 에서 얻은 기 억 기 장치상황으로 된다. 

SourceX 및 SourceY 에 는 복사측의 비 트매 프의 왼쪽웃모서 리 의 자리 표를 설정 한다. 
dwHow 에는 비트매프를 화면에 어떻게 그리는가를 설정한다. 자주 사용되는 dwHow 
의 설정값(마크로)을 아래에 보여 주었다. 


DSTINVERT 

전송측의 비트매프를 반전한다. 

SRCAND 

전송원과 전송측의 비 트매 프로 AND 연산을 진행한다. 

SRCCOPY 

전송원의 비트매프를 복사하고 전송측에 덧쓰기한다. 

SRCPAINT 

전송원과 전송측의 비 트매프로 OR 연산을 진행한다. 

SRCINVERT 

전송원과 전송측의 비 트매 프로 XOR 연산을 진행한다. 


BitBltC ) 는 호출이 성공하면 령 아닌 값을 돌려 주며 실패하면 령을 돌려 준다. 
실례프로그람에서 BitBlt () 에 대한 두개의 호출은 어느것이나 다 비트매프전체를 창 
문의 의뢰자구역따 복사하고 있다. 

비트매프가 표시되면 두개의 장치상황을 해제한다. 여기에서는 BeginPaintC )로 얻 
은 장치 상황을 해제 하기 위 해 EndPaintC ) 가 호출되 고 있 다. 
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CreateCompatibleDC ( ) 를 리 용 하 여 호 출된 기 억 기 장 치 상 황 을 해 제 하 려 면 
DeleteDCC )를 사용하여 야 한다. DeleteDC ( ) 에 보내는 파라메 터는 해제 할 장치상황의 
손잡이로 된다. 여기에서는 ReleaseDC () 를 사용할수 없다. ( GetDC () 에서 엄은 장치상 
황만이 ReleaseDCC ) 를 사용하여 해 제할수 있 다. ) 


비트매프의 삭제 


비트매프는 응용프로그람의 완료시에 삭제해야 할 자원이다. 그렇게 하기 위해서는 
비트매프가 필요 없게 되였을 때 혹은 竹^幻요57次 or 통보문을 받았을 때 프로그람에서 
DeleteObjectC )를 호출하여 야 한다. 아래 에 DeleteObjectC ᄉ의 선언을 보여 주었 다. 

BOOL DeleteObject (HGDIOBJ hObj ) : 

hObj 에 삭제할 객체 (여기서는 비트매프)의 손잡이를 설정한다. 함수의 호출이 성공 
하면 령 아닌 값을 돌려 주며 실패하면 령이 돌려 진다. 

비트 매프의 완성된 실례 프로그람코드 

비트매프의 실례를 보여 주는 완전한 프로그람코드를 실례 7-1 에 주었다. 

실례 7-1. Bp 프로그람 
// 비트매프의 표시 

♦include < windows. h> 

♦include <cstring> 
ttinclude <cstdio> 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM); 

char szWinName[] = "MyWin "； // 창문클라스의 이름 

HBITMAP hbit ； // 비트매프의 손잡이 

HINSTANCE hlnst; // 실체의 손잡이 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 


교육성 프로그람교육멘터 


197 




Windows 2000 프로그람작성 법 


MSG msg ； 

WNDCLASSEX wcl ； 

// 창문물라스를 정의 한다 . 

wcl. cbSize = sizeof (WNDCLASSEX) : 


wcl.Mnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문콜라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) : // 큰 아이 콘 

wcl. hlconSm = NULL ； // 큰 아이론의 축소판을 사용한다 . 

wcl. hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl.IpszMenuName = NULL ； // 믈라스차림표는 없음 
wcl.cbClsExtra = 0; // 보조기 억기 령 역은 불필요함 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색은 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) : 

// 창문을 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


hlnst = hThisInst ； // 실체의 손잡이를 보관한다 . 

A 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow( 
szWinName, // 창문믈라스의 이름 
"Displaying a Bitmap", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자리 표는 Windows 가 결 정 하게 한다 . 
CWJJSEDEFAULT, // Y 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 높이 는 Windows 가 결 정 하게 한다 . 
NULL, // 어미창문은 없다 . 
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NULL, 
hThisInst, 

NULL 

)； 

// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd) ； 

// 통보문순환고리률 작성 한다 . 

while(GetMessage (&msg, NULL, 0, 0)) 

{ 

TranslateMessageUmsg); // 건반통보률 변환한다 . 
DispatchMessage(&msg) ； // Windows 2000 에 조종을 넘 긴다 . 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc, memdc ； 

PAINTSTRUCT ps ； 

switch (message) { 
case WM_CREATE ： 

// 비트매프의 적재 

hbit = LoadBitmap(hInst, "MyBP") ； // 비트매프률 적재 한다 . 
break ； 

case WM 一 PAINT: 

hdc = BeginPaint (hwnd, &ps) ； // 장치 상황을 얻 는다 . 

memdc = CreateCompatibleDC(hdc) ； // 호환성 있는 장치 상황을 얻는다 . 
SelectObject (memdc, hbit) ； // 비 트매 프률 선택 한다 . 

BitBlt(hdc, 10, 10, 256, 128, 

memdc, 0, 0, SRCCOPY); // 화상을 표시 한다 . 

BitBlt(hdc, 300, 100, 256, 128, 

memdc, 0, 0, SRCCOPY); // 화상을 표시 한다 . 


// 차림표는 없다 . 

// 실체의 손잡이 
// 추가파라메터 는 없 다 . 
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EndPaint (hwnd, &ps) ； // 장치 상황을 해 제 한다. 
DeleteDC(memdc) ; // 기 억 기 장치 七■황을 해 제 한다. 
break； 

case WM_DESTROY： // 프로그람을 끝낸다. 

DeleteObject(hbit) ; // 비트매프를 삭제 한다. 

PostQuitMessage (0) ； 
break； 
default： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 이 처 리 하게 한다. */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 

} 

return 0； 


프로그람의 실행 결과는 그림 7-2 에 보여 주었다. 



그림 7-2. 비트매프 프로그람의 실행결과 


이 실례프로그람을 개 조하여 여 러 가지 실험 을 해보는것 이 유익하다. 실례 로 
BitBltC ) 의 파라메터 들을 변경해 보는것 등이 다. 다른 크기 의 비 트매 프 등도 실제 로 시 
험해 보는것 이 좋다. 
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|다시 한보 전진| 


창문과 화상의 XOR 연산 

이 장에 서 설 명 한것 처 럼 BitBlt () 로는 여 러 가지 방법 으로 한 장치 상황으로 
부터 다른 장치상황에 비트매프를 복사할수 있다. 실례로 SRCPAINT 을 지정 
하면 화상은 전송측과 OR 연산된 다. SRCAND 를 지 정하면 화상이 전송측과 
AND 연산된 다. 

이 방법들가운데서 가장 용도가 높은것은 SRCINVERT 이 다. 이 방법에서 
는 전송원(화상)과 전송측(창문)이 XOR 연산된다. 이것이 자주 쓰이는 리유는 
두가지이다. 

첫번째 리유는 창문과 화상을 XOR 연산하면 화상의 표시가 보증된다는것 
이다. 전송원과 전송측에서 어떤 색 이 사용되는가에는 관계 없이 XOR 연산된 
화상은 명 확하게 표시된다. 

두번째 리유는 같은 화상을 같은 위치에 두번 련속 XOR 연산하면 전송측의 
화상이 복원된 다는것 이 다. 그러 므로 XOR 연산은 화상을 일시 적 으로 표시 하였다가 
원래 화상을 못 쓰게 하지 않고 복귀시키는데 효과적 인 방법 으로 된다. 

창문과 화상을 XOR 연산한 효과를 확인하려 면 먼저 작성한 비 트매 프프로 
그람의 WindowFuncC ) 에 아래 와 같은 case 문을 삽입 해 보면 알수 있 다. 

case WM_LBUTTONDOWN : 

hdc = GetDC(hwnd); 

memdc = CreateCompatibleDC(hdc) : // 호환성 있는 장치 상황을 작성 
SelectObject(memdc , hbit) ; // 비 트매 프를 선택 한다 . 

// 창문과 화상을 XOR 연산한다 . 

BitBlt(hdc, LOWORD(lParam) , HIWORD (IParam) , 256, 128, 
memdc, 0, 0, SRCINVERT); 

ReleaseDC(hwnd, hdc); 

DeleteDC (memdc ); 
break; 

case WM_LBUTTONUP ： 

hdc = GetDC (hwnd ); 

memdc = CreateCompatibleDC(hdc) : // 호환성 있는 장치 상황을 작성 
SelectOb ject (memdc , hbit); // 비트매프를 선택 한다 . 
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// 창문과 화상으로 두번 XOR 연산을 진행한다 . 

BitBlt(hdc, LOWORD(lParam) , HIWORD (IParam) , 256, 128, 
memdc, 0, 0, SRCINVERT); 

ReleaseDC (hwnd, hdc); 

DeleteDC (memdc ); 
break; 

이 프로그람코드는 다음과 같이 동작한다. 마우스의 왼쪽 단추를 누르면 
마우스지시자의 위치에서 창문과 화상이 XOR 연산되고 반전된 비트매프의 화 
상이 표시된다. 그대로 마우스의 왼쪽 단추를 놓으면 화상에 두번째 XOR 연산 
이 진행되여 비트매프가 소거되고 창문이 본래의 상태로 돌아 간다. 

마우스의 왼쪽 단추를 누른 상태 에 서 마우스를 움직 이 지 않도록 주의해 야 
한다. 그렇지 않으면 처음과 갈은 위치에서 두번째 XOR 연산이 진행되지 않기 
때문에 창문이 본래의 상태로 돌아 가지 않는다. 


비트매프의 동적작성 


비트매프자원을 사용하기만 하는것이 아니라 프로그람에서 동적으로 비트매프를 작 
성할수도 있 다. 비 트매 프자원의 내 용은 미 리 정 의 된것 으로서 프로그람의 실 행 중에 작성 
되는것은 아니다. 

비 트매 프를 동적으로 작성하기 위 한 가장 간단한 방법 은 CreateCompatibleBitmap(M 
는 API 함수를 사용하는것이다. 이 함수는 지정된 장치상황과 호환성 이 있는 장치의존비 
트매프를 동적으로 작성한다. 아래에 선언을 보여 주었다. 

HBITMAP CreateCompatibleBitmap (HDC hdc , int width , int height ) : 

hdc 는 호환성 있는 비 트매 프를 작성 하는 장치상황의 손잡이 이다. 비 트매 프의 크기 
는 wld 比!와 height 로 설정된다. 이것들의 단위는 화소이 다. 이 함수는 호환성 있는 비 
트매 프의 손잡이 를 돌려 주며 호출이 실패한 경 우는 NULL 을 돌려 준다. 초기 에 비 트 
매프는 비여 있다. 
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동적으로 작성된 비트매프의 사용법 

비 트매 프를 필 요에 따라 동적 으로 작성할수 있 는 기 능은 여 러 가지 측면 에 서 활용할 
수 있다. 동적으로 작성된 비트매프를 사용하여 실행시에 화상을 구축할수 있다. 동적으 
로 작성된 비 트매 프에 거대한 비트매 프의 화상 또는 그의 일부를 일시 적 으로 보관할수도 
있 다. 

동적 으로 작성 된 비 트매 프의 가장 편리한 사용방법의 하나로서 창문의 의 뢰 자구역의 
내 용을 비 트매 프에 복사하는것 이 있 다. 이 에 의해 창문의 내 용을 간단히 보관할수 있 다. 

동적 으로 작성된 비트매 프의 사용방법 을 익히기 위해 간단한 실례프로그람을 작성 해 
보자. 이 프로그람은 창문의 일부 령역을 다른 령역에 복사하는 프로그람이다. 프로그람 
은 다음과 같이 동작한다. 우선 마우스의 왼쪽 단추를 누르면 마우스의 현재위치를 왼쪽 
웃모서리로 하여 창문의 100/100화소의 령역이 동적으로 작성된 비트매프에 복사된다. 
다음 마우스의 오른쪽 단추를 누르면 창문에서 마우스의 현재위치에 비트매프가 복사된 
다. 다시말하여 기본창문의 일부를 의뢰자구역에 임의로 복사한다. 

동적비 트매 프프로그람의 전체 코드를 실례 7-2 에 보여 주었 다. 

실 례 7-2. Dynamic 프로그람 


/* 이 프로그람은 동적으로 비트매프를 작성하고 
기 본창문의 의 뢰 자구역 에 부분적 으로 복사한다 . */ 

ttinclude 〈 windows. h> 
ttinclude <cstring> 
itinclude <cstdio> 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM); 

char szWinName[] = ’’MyWin”; // 창문들라스의 이름 

HINSTANCE hlnst; // 실체의 손잡이 

HBITMAP hdynbit ； // 동적으로 작성된 비트매프의 손잡이 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

// 창문믈라스률 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ； 


wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정형식 


교육성 프로그람교육쎈터 


203 




Windows 2000 프로그람작성 법 


wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) : // 큰 아이 콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl.If 保 zMenuName = NULL ； // 믈라스차림표는 없음 
wcl.cbClsExtra = 0 ； // 보조기억기령역은 불필요함 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색은 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) : 


// 창문콜라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


hlnst = hThisInst ； // 실체의 손잡이를 보관한다 . 

A 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문클라스의 이름 
"Using Dynamic Bitmaps", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림 표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

)； 


// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) : 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while(GetMessage(&msg , NULL, 0, 0)) 

{ 

TranslateMessage(&nsg); // 건반통보를 변환한다 . 
DispatchMessage(&msg) : // Windows 2000 에 조종을 넘 긴다 . 

} 

return msg.wParam; 


/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc(HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 


{ 
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HDC hdc, memdc ； 

PAINTSTRUCT ps ； 
int i ； 

char str[80] = ” Using a dynamic bitmap." ； 

char instructions [] = "Click left button at source, ’’ 

"right button at destination. ” ； 

switch (message) { 
case WM_CREATE ： 

// 비트매프를 동적으로 작성한다 . 
hdc = GetDC(hwnd) ； 

hdynbit = CreateCompatibleBitmapChdc, 100, 100) ； 

ReleaseDC (hwnd, hdc) ； 
break ； 

case WM_LBUTTONDOWN : // 창문의 일부를 비트매프에 복사한다 . 
hdc = GetDC(hwnd) ； 

memdc = CreateCompatibleDC(hdc) ； // 호환성 있는 장치 상황을 작성 한다 . 

// 동적비트매프를 기 억기장치상황에 선택한다 . 

SelectObject (memdc, hdynbit) ； 

// 령역을 동적비트매프에 복사한다 . 

BitBlt (memdc, 0, 0, 100, 100, 

hdc, LOWORD(lParam), HIWORD(lParam), SRCCOPY) ； 

ReleaseDC (hwnd, hdc) ； 

DeleteDC (memdc); 
break ； 

case WM_RBUTTONDOWN : // 비트매 프률 창문에 복사한다 . 
hdc = GetDC(hwnd) ； 

memdc = CreateCompa 付 bleDC(hdc) ; // 호환성 있는 장치 상황을 작성 한다 . 


// 동적비트매프를 기 억기장치상황에 선택한다 . 
SelectObject (memdc, hdynbit) ； 


// 동적 비트매프를 창문에 복사한다 . 

BitBlt (hdc, LOWORD(lParam), HIWORD(lParam), 100, 100, 
memdc, 0, 0, SRCCOPY) ； 


ReleaseDC (hwnd, hdc) ； 

DeleteDC (memdc); 
break ； 

case WM_PAINT ： 

hdc = BeginPaint (hwnd, &ps) ； // 장치 상황을 얻 는다 . 
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TextOut(hdc, 1, 0, instructions, strlen(instructions)) ； 
for(i=l ； i<10 ； i++) 

TextOut(hdc, 1, i*20, str, strlen(str)) ； 

EndPaint(hwnd, &ps) ； // 장치 상황을 해 제 한다 . 
break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 
DeleteObject(hdynbit) ； // 비트매프를 삭제 한다 . 
PostQuitMessage (0) ; 
break ； 
default ： 

/* 이 switch 문에서 지정되지 않은 통보문들은 
Windows 2000 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam); 


return 0 ； 

} 

프로그람의 실행 결과는 그림 7-3 에 보여 주었다. 


Click left button at source, right button at destination. 


Using a dynamic bitmap 
Using a dynamic bitmap 
Using a dynamic bitmap 
Using a dynamic bitmap 
Using a dynamic bitmap 
Using a dynamic bitmap 
Using a dynamic bitmap 
Using a dynamic bitmap 
Using a dynamic bitmap 


dynamic bitma 
dynamic bitma 
dynamic bitma 
dynamic bitma 

.. 4 dynamic bitma 
dynamic b ， tma 『 

dynamic bitma- 
dynamic bitma- 
dynamic bitma- 


그림 7-3. 동적비 mi ] ᅢ프프로그람의 실행결과 
프로그람이 실행하고 기본창문이 WM_CREATE 통보문을 받았을 


기본창문에서 
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사용되는 장치상황과 호환성 있는 비트매프가 작성된다. 이 비트매프의 손잡이는 대역변 
수 hdynbit 에 보관된 다. 

마우스의 왼쪽 단추가 눌러우면 호환성 있는 기억기장치상황이 작성되고 그 장치상 
황에 비 트매프가 선택되 여 창문의 100 Z 100 화소의 4 각형 령 역 이 비 트매 프에 복사된다. 
마우스의 오른쪽 단추가 눌러우면 갈은 순서로 처리가 진행되는데 전송측과 전송원은 반 
대로 된다. 이 런 절차에 의하여 비트매프의 내용이 창문에 복사된다. 

동적 으로 비 트매 프를 작성하는 기 능에 는 여 러 가지 활용방법 이 있 다. 

다시그리기문제의 해결방법 


비트매프를 취급하는데 필요되는 기본적인 지식을 습득하였으므로 이제는 그 지식을 
활용하여 Windows 2000 프로그람작성에 있어서의 가장 기본적인 문제를 해결하기로 하 
자. 이 문제는 WM_PAINT 통보문을 받았을 때 창문의 내용을 다시 그리는것 이 다. 

Windows 2000(및 모든 판본의 Windows ) 에서는 WM_PAINT 통보문을 받을 때마 
다 창문의 의 뢰 자구역의 내 용을 다시 그리 기 하는것 이 응용프로그람의 역 할로 되 여 있 다. 

일 반적 으로 창문이 재 표시 될 때는 그 내 용을 다시 그려야 한다. 프로그람을 실행하 
고 창문의 의뢰자구역에 어떤 출력을 진행한 다음 그것 이 다른 창문의 밑에 가리웠다면 
출력한 내용이 없어 진다. 그때문에 창문이 재표시될 때 그 내용을 다시그리기할 필요가 
있는것 이다. 비트매프의 표시에서 리용한 기술을 이 다시그러기문제를 해결하는데 사용 
할수 있다. 

먼저 창문을 다시 그리 기 하기 위 한 세 가지 기 본적 인 방법 을 복습하자. 

첫번째 방법은 어떤 계산에 의해 출력된 내용을 다시 작성하고 변경하는것 이 다. 

두번째 방법은 표시에 관계되는 사건을 기록해 두고 그 사건들을 재생하는것 이다. 

그리 고 세 번째 방법 은 가상창^을 작성 하고 WM_PAINT 통보문을 받을 때 마다 가상 
창문의 내용을 실제 창문에 단순히 복사하는것이다. 이가운데서 가장 일반적 인 방법은 
물론 세번째 방법이다. 실제로 프로그람을 작성해 보자. 

가상창문을 사용하여 다시그리 기 를 진행하는 순서 는 다음과 같다. 

우선 응용프로그람에서 사용되고 있는 실제의 장치상황과 호환성이 있는 기억기장치 
상황 및 비트매프(이것 이 가상창문으로 된다.)를 작성한다. 

다시 말하여 가상창문이 란 프로그람의 실제창문과 호환성 을 가지 는 비 트매 프인것 이 다. 
가상창문을 작성한 다음에는 기본창문의 의뢰 자구역 에 출력되는 모든 내용을 가상창문에 
도 써넣어야 한다. 

이렇게 하면 가상창문의 내용은 실제창문의 내용의 완전한 복사판으로 된다. 
WM_PAINT 통보문을 받으면 가상창문의 내용을 실제창문에 복사하여 창문의 내용을 다 
시그리 기한다. 이렇게 일 단 가리워 있다가 다시 표시된 창문이 WM_PAINT 통보문을 
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받았을 때 그 내용이 자동적으로 다시그리기된다. 

필요한 API 함수 

가상창문을 실 현하는데 몇 가지 API 함수가 필 요된 다. 그중 다섯 개 는 이 미 설 명한것 
으 로 서 CreateCompatibleBitmap ( ), CreateCompatibleDC( 入 SelectObject( 入 
GetStockObject( ) 및 BitBlt( )。] 다. 그밖에 PatBlt( ) 타 GetSystemMetrics( )A 필 요되 
므로 여기에서 이 함수들의 기능을 설명을 하기로하자. 


PatBltC ) 

PatBltO 함수는 현재 선택되여 있는 붓의 색과 무늬로 4각형령역을 채운다. 붓이란 
창문 또는 령역을 채우기 위한 객체이다. 붓을 사용하여 령역을 채운다는것은 령역을 색 
칠 한다는것 을 의 미 한다. 아래 에 PatBlt( )S\ 선언을 보여 주었 다. 

BOOL PatBlt (HDC hdc , int X , int Y , int width , int height , 

DWORD dwHow ) : 

hdc 는 색 칠을 진행 하는 장치 의 손잡이 이 다. X 와 Y 에 색 칠 하는 령 역 의 왼쪽웃모서 
리의 자리표를 설정한다. 령역의 너비와 높이를 wid 仕 l 와 height 에 설정한다. dwHow 
의 값은 붓의 사용방법을 지정 하며 아래의 마크로들중에서 어느 하나의 값을 설정 한다. 




BLACKNESS 

령역이 무색으로 된다.(붓은 무시된다.) 

WHITENESS 

령역이 백색으로 된다.(붓은 무시된다.) 

PATCOPY 

붓이 령역에 복사된다. 

PATINVERT 

붓과 령 역 이 OR 연산된 다. 

DSTINVERT 

령역이 반전된다. (붓은 무시된다.) 



붓을 그대 로 사용하려 면 dwHow 에 PATCOPY 를 설정 하면 된다. 호출이 성 공하면 
PatBltC ) 는 령 아닌 값을 돌려 주며 실패하면 령을 돌려 준다. 

체계치수를 얻기 

가상창문을 작성하려 면 가상창문에 서 리 용되 는 비 트매 프의 크기 를 알아야 할 필요가 
있다. 그를 위한 방법의 하나로서 화면의 크기를 화소단위로 얻고 그것을 비트매프의 크 
기 로 할수 있 다. 화면크기 등의 정 보를 엄 으려 면 GetSystemMetrics( ) 라는 API 함수를 
사용한다. 아래에 선언을 보여 주었다. 


int GetSystemMetrics (int what ) : 


208 


교육성 프로그람교육쎈터 









제 7 장. 비 트매프의 사용법과 다시그리기문제의 해결방법 


what 은 얻 으러 는 정 보를 지 정 한다. GetSystemMetrics ( ) 을 사용하면 여 러 가지 정 
보를 엄 을수 있 다. 아래 에 what 에 지 정 할수 있는 주요한 값들을 표시 한다. 


SM.CXFULLSCREEN 

최대화되였을 때의 의뢰자구역의 너비 

SM CYFULLSCREEN 

최대화되였을 때의 의뢰자구역의 높이 

SM—CXICON 

표준적인 아이콘의 너비 

SM.CYICON 

표준적인 아이콘의 높이 

SM—CXSMICON 

작은 아이콘의 너비 

SM.CYSMICON 

작은 아이콘의 높이 

SM.CXSCREEN 

화면전체의 너비 

SM_CYSCREEN 

화면전체의 높이 


여 기 에서 는 가상창문의 크기를 결정 하기 위 해 SM_CXSCREEN 4 SM—CYSCREEN 
을 사용하기 로 한다. 이 마크로들을 지정 하여 얻어지 는 값의 단위는 화소이 다. 

가상창문의 작성과 사용방법 

이 제 부터 작성하게 될 프로그람의 내 용에 대 해 간단히 설명 한다. 

WM_PAINT 통보문을 받았을 때 창문을 다시그리 기하는 간단하고 편리 한 방법 으로 
가상창문을 작성한다. 창문의 의 뢰 자구역 에 출력 되 는 내 용은 뭍근/장문(실 제 창문) 과 가 
상창문(동적으로 작성된 비트매프)의 량측에 써넣기된다. 다시그러기요구를 받을 때마다 
가상창문의 내 용이 실제 로 화면에 표시 되 여 있는 물리 창문에 복사된다. 이 에 의해 창문 
의 내 용이 다시그리 기된다. 

가상창문을 작성하기 위해 제일 먼저 진행해야 하는 처리는 실제의 장치상황과 호환 
성이 있는 기억기장치상황을 얻는것이다. 이것은 창문이 처음 작성되였을 때 한번만 진 
행하는 처리이다. 호환성 있는 장치상황은 프로그람이 실행하는 동안 보관된다. 아래에 
이 기능을 실현하는 프로그람 코드를 보여 준다. 

case WM_CREATE ： 

// 화면의 크기률 엄는다 . 

maxX = GetSystemMetrics (SM_CXSCREEN) ； 

maxY = GetSystemMetrics (SM_CYSCREEN) ； 


// 호환성 있는 기억기화상을 작성한다 . 

hdc = GetDC(hwnd) ； 

memdc = CreateCompatibleDC(hdc) ; 
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hbit = CreateCompatibleBitmap (hdc, maxX, maxY) : 

SelectObject (memdc, hbit) : 

hbrush = GetStockObject(WHITE_BRUSH); 

SelectObject(memdc, hbrush); 

PatBlt (memdc, 0, 0, maxX, maxY, PATCOPY); 

ReleaseDC (hwnd, hdc); 
break ； 

프로그람코드의 내용을 구체적으로 따져 보자. 먼저 화면의 크기를 엄는데 이 값은 
호환성 있는 비 트매 프를 작성하는데 쓰인 다. 다음 현재 의 장치상황을 얻는다. 그리 고 
CreateCompatibleDC ( )를 호출하여 호환성 있는 장치상황을 기억기에 작성 한다. 이 장 
치 상황의 손잡이 는 대 역 변수 memdc 에 보관된다. 

다음 호환성 있는 비트매프를 작성한다. 이것은 가상창문과 물리창문에 1:1 대응된 
다. 비트매프의 크기가 화면의 최대 크기로 되여 있으므로 물리적창문의 크기가 어떤 크 
기 라고 해 도 비 트매 프는 창문을 다시그러 기하는데 충분한 크기 로 된 다. (실제 로는 약간 
작은 크기 로 해 도 상관 없다. 왜 냐하면 창문의 경계선을 다시 그리 기할 필요는 없기때 문 
이다.) 비트매프의 손잡이는 대역변수 hbit 에 보관된다. 이것을 기억기장치상황에 선택 
한다. 

다음 흰색의 붓을 선택하고 그의 손잡이를 대역변수 hbrush 에 보관한다. 이 붓을 
기 억기장치 상황에 선택하고 PatBlt () 를 호출한 다음 가상창문전체를 색칠 한다. 이 에 의 
해 가상창문의 배경이 흰색으로 되며 다음에 작성하는 실례프로그람의 물러적창문의 배 
경색과 같이 된다. 

마지 막으로 물리창문의 장치상황이 해제된다. 그러 나 기 억기 장치상황은 프로그람을 
완료할 때까지 해제되지 않는다. 

가상창문을 작성하면 반드시 모든 출력 을 가상창문에도 동시 에 해 야 한다. 
WM_PAINT 통보문을 받을 때 마다 물리창문의 내 용을 다시그리기하는데 가상창문의 내 
용을 러용한다. 이것을 실현하는 방법은 앞절에서 BitBltC ) 함수를 사용하여 창문에 비트 
매프의 화상을 복사하는것과 갈다. 

가상창문의 실례를 보여 주는 전체 프로그람코드 

다시그리 기 문제 를 해결하기 위하여 가상창문을 사용하는 실례 를 보여 주는 완전한 
프로그람코드를 실례 7-3 에 보여 주었다. 

이 프로그람은 WM_CHAR 통보문에 응답하여 가상창문과 물리창문의 량측에 문자 
렬 을 출력한다. (이 것 은 건입 력 된 문자렬 을 물리창문과 가상창문의 량측에 표시 한다는것 
이 다. ) WM_PAINT 통보문을 받았을 때 물리창문을 다시그리 기하기 위해 가상창문의 
내용을 리용한다. 
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실례 7-3. Repaint 프로그람 


// 가상창문을 리용한 다시그러기 


^include < windows. h> 
itinclude <cstring> 
ttinclude <cstdio> 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 

char szWinName[] = n MyWin，，; // 창문클라스의 이름 

char str[255] ； // 출력 할 문자렬 을 보관한다 . 

int X=0, Y=0 ； // 현재 출력위치 

int maxX, maxY; // 화면의 크기 

HDC memdc ； // 가상장치손잡이를 보관한다 . 

HBITMAP hbit ； // 가상비트매프를 보관한다 . 

HBRUSH hbrush ； // 붓의 손잡이를 보관한다 . 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl; 

// 창문들라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ; 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName; // 창문콜라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0 ； // 체계설정의 형식 


wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ； // 큰 아이론 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
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wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 

wcl.IpszMenuName = NULL ； // 들라스차림표는 없다 . 
wcl.cbClsExtra = 0 ； // 보조기 억기령 역은 불필요함 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) : 

// 창문콜라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 

A 창문들라스가 등록되였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow( 
szWinName, // 창문믈라스의 이름 
"Using a Virtual Window", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자리 표는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 

NULL, // 어미창문은 없다 . 


// 차림 표는 없다 . 

// 실체의 손잡이 
// 추가파라메터는 없다 . 


NULL, 

hThisInst, 

NULL 


)； 

// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성한다 . 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage(Smsg) : // Windows 2W)0 에 조종을 넘 긴다 . 

} 
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/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받는다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 

PAINTSTRUCT ps ； 


switch (message) { 
case WM.CREATE ： 

// 화면의 크기를 엄는다 . 

maxX = GetSystemMetrics(SM_CXSCREEN) ； 

maxY = GetSystemMetrics(SM_CYSCREEN) ； 


// 호환성 있는 기억기화상을 작성한다 . 

hdc = GetDC(hwnd) ； 

memdc = CreateCompa 切 bleDC(hdc) ; 

hbit = CreateCompatibleBitmap (hdc, maxX, maxY) ； 

SelectObject (memdc, hbit) ； 

hbrush = (HBRUSH) GetStockObject(WHITE_BRUSH) ； 
SelectObject (memdc, hbrush) ； 

PatBlt (memdc, 0, 0, maxX, maxY, PATCOPY) ； 

ReleaseDC (hwnd, hdc) ； 
break ； 

case WM_CHAR: 
hdc = GetDC(hwnd) ； 

sprintf (str, " 초 c”, (char) wParam); // 문자률 문자렬로 한다 . 

// 복귀 , 개행의 간단한 처리 
if((char)wParam == ’\r’) { 

Y += 16 ； // 개 행 한다 . 

X = 0 ； // 복귀한다 . 

} 

else { 

TextOut (memdc, X, Y, str, 

strlen(str)) ； // 기 억기 에 출력 한다 . 

TextOut (hdc, X, Y, str. 
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strlen(str)) ； // 창문에 출력 한다 . 

X += 10 ； 

} 

ReleaseDC (hwnd, hdc) ； 
break ； 

case WM.PAINT ： // 다시 그러 기요구를 처 리 한다 . 
hdc = BeginPaint(hwnd, &ps) ； // 장치 상황을 얻 는다 . 

// 기억기화상을 화면에 복사한다 . 

BitBlt(hdc, 0, 0, maxX, maxY, memdc, 0, 0, SRCCOPY) ； 

EndPaint(hwnd, &ps) ； // 장치 상황을 해 제 한다 . 

break ； 

case WM.DESTROY ： // 프로그람을 완료한다 . 
DeleteDC(memdc) ； // 기억기장치 상황을 해제 한다 . 
DeleteObject(hbit) ； // 비트매프률 삭제 한다 . 
PostQuitMessage (0) ； 
break ； 
default ： 

A 이 switch 문에서 지정되지 않은 통보문들은 
Windows 2000 이 처 리 하게 한다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 

} 

return 0 ； 

} 

프로그람의 실행 결과를 그림 7-4 에 보여 주었다. 
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그림 7-4. 가상창문 프로그람의 실행결과 
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프로그람의 내용을 상세히 보자. 먼저 WM_CHAR 통보문과 관련된 프로그람코드를 
설 명 한다. 

case WM—CHAR: 
hdc = GetDC(hwnd) : 

sprintf(str, "%c", (char) wParam) : // 문자를 문자렬로 한다 . 

// 복귀 , 개행의 간단한 처리 
if((char)wParam == ’\r’) { 

Y += 16 ； // 개행한다 . 

X = 0 ； //복귀 한다 . 

} 

else { 

TextOut (memdc, X, Y, str, 

strlen(str)) ； ft 기 억 기 에 출력 한다 . 

TextOut(hdc, X, Y, str, 

strlen(str)) ； // 창문에 출력 한다 . 

X += 10 ； 

} 

ReleaseDC(hwnd, hdc); 
break ； 

옹근수형의 대 역변수 X 와 Y 는 출력할 문자의 위 치를 지정하는데 사용된다. 이 변 
수들의 값은 령으로 초기화되여 있다. 문자가 입력되면 문자가 문자렬로 변환되고 물리 
창문과 가상창문의 량쪽에 출력된다. 이렇게 되여 건입력의 완전한 복사가 가상창문에도 
써넣어 진다. 

한 문자의 입력에 대해 표 의 값이 10 씩 증가하며 [ Enter ] 건이 눌러우면 Y 의 값이 
16 만큼 중가하여 개행이 진행된다는것을 알수 있다. 이것은 X 와 Y 의 위치를 결정하기 위 
한 간단한 방법 이 다. 다음 장에서는 문자렬을 가장 정확하게 출력하는 방법을 설명한다. 

WM_PAINT 통보문을 받을 때마다 가상창문의 내용이 물리창문에 복사되 여 그의 
내용이 다시그리기된다. 이것은 아래의 프로그람코드에서 실현되고 있다. 

case WM_PAINT ： // 다시 그리기요구를 처 리 한다 . 
hdc = BeginPaint (hwnd, &ps) ; // 장치 상황을 얻 는다 . 

// 기억기화상을 화면에 복사한다 . 

BitBlt(hdc, 0, 0, maxX, maxY, memdc, 0, 0, SRCCOPY); 

EndPaintChwnd, &ps); // 장치 상황을 해 제 한다 . 
break ； 
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BitBltC ) 함수는 memdc 로부터 hdc 에 화상을 복사한다. 5 KOXIP 1" 파라메 터 는 전송 
원의 화상을 변화시키지 않고 전송측에 복사할것을 지정한다. 모든 출력 이 memdc 에 보 
관되여 있으므로 이 처리를 진행하여 창문을 다시그리기할수 있다. 어떤 문자를 입력한 
다음 창문을 다른 창문에 가리우게 하였다가 다시 표시하면 입력된 문자가 다시그리기되 
는것을 학인할수 있다. 

가상창문을 사용하여 다른 방법으로도 다시그러기를 진행할수 있다. 정보를 두번 출 
력하지 않고 물리창문과 가상창문의 어느 한 측에 출력하는 경우 건입력시에는 출력창문 
에 만 출력 을 하고 거 기서 InvalidateRect ( )를 호출하면 물리 창문에 도 출력 할수 있 
다. (제 3 장에서 설명 한것 처 럼 InvalidateRect ( ) 는 WM_PAINT 통보문을 생성 한다.) 

그러 나 이 방법 을 리 용하면 건입 력 을 진행할 때 마다 창문이 다시 그리 기 되므로 창문 
이 약간 흐르는것 처 럼 보이게 된다. 그러므로 여 기서 작성한 실례 프로그람에서 는 이 방 
법 이 적 합치 못하다. 하지만 출력 이 거의 나 변화되지 않는 프로그람이라면 이 방법도 적 
용할수 있다. 


다시그리기기능의 개선 


지 금까지 설 명한것 은 가상창문을 리 용하여 다시 그리 기 를 진행하는 일 반적 인 방법 이 
였다. 하지만 프로그람을 보다 간단하게 개 량할수도 있다. 

앞에서 본 프로그람에는 두가지 문제가 있다. 첫번째 문제는 물리창문의 크기에 관 
계 없이 가상창문전체가 물리창문에 복사된다는것이다. 가상창문의 크기가 화면전체의 
크기와 갈으므로 이 방법에는 명백히 결함이 있다. 물론 이렇게 해도 표시상에서는 문제 
가 없지만 CPU 시간을 랑비하게 된다. 

두번째 문제는 물리 창문에서 다시 그리 기할 령역의 크기 에 관계 없이 WM_PAINT 통 
보문을 받을 때 마다 창문전체 를 다시 그리기 하는것 이 다. 이것은 Windows 프로그람작성 
경험이 적은 사람들이 사용하는 방법이며 물론 최량의 방법은 아니다. 

실제로 다시그리기가 필요로 되는것은 대체로 창문의 일부분만이다. 창문을 다시그 
리기하는데는 많은 시간이 걸린다는것을 잊어서는 안된다. 창문이 크면 들수록 다시그리 
기 에는 긴 시 간이 소모된다. 창문에서 다시 그러기 가 불필요한 부분까지 다시그러기하는 
것은 시간을 랑비하고 응용프로그람의 성능을 저하시킨다. 

창문에서 실제로 다시그리기해야 할 부분만을 다시그리기하도록 프로그람을 고치면 
다시그리기의 시간이 단축되고 응용프로그람은 빠른 속도로 동작하게 된다. 프로그람의 
성능을 향상시키 려면 창문의 다시그리 기를 최 량화하는것 이가장 효과적 이 다. 

Windows 2000 은 보다 효률적 인 다시 그리 기 처 리를 실현하는데 필요되는 정보를 
BeginPaintC ) 에서 제공해 준다. 
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BeginPaint ( ) 의 상세 

제 3 장에 서 설 명 한것 처 럼 WM_PAINT 통보문을 처 리 할 때 는 BeginPaintC ) 를 호출 
하여 장치상황을 얻어야 한다. 장치상황을 엄는것외에도 BeginPaint ( ) 에서는 창문의 
표시상태 에 관계되는 정보도 엄을수 있다. 이 정보를 사용하여 다시그러기를 최적화할수 
있 다. 

아래 에 다시 한번 BeginPaint ( ) 의 선언을 보여 주었다. 


HDC BeginPaint(HWND hwnd , PAINTSTRUCT * lpPS ) ; 


BeginPaintC ) 의 호출이 성공하면 장치상황의 손잡이를 돌려 주며 실패하면 NULL 
을 돌려 준다. hwnd 는 장치 상황을 엄 으려 는 창문의 손잡이 이 다. 두번째 파라메 터 는 
PAINTSTRUCT 구조제와 지 시 자이다. IpPS 에서 지 정된 구조체 는 창문을 다시그리 기하는 
데 리용되는 정보를 가지고 있다. PAINTSTRUCT 의 정의를 아래에 보여 주었다. 


typedef struct tagPAINTSTRUCT { 
HDC hdc ； 

BOOL fErase ； 

RECT rePaint ； 

BOOL fRestore ； 

BOOL flncUpdate ； 

BYTE rgbReserved[32] ； 
}PAINTSTRUCT ； 


// 장치상황의 손잡이 
// 배경을 소거해야 하는 경우는 TRUE 
// 다시그리기해야 하는 령역의 자리표 
// Windows 에 예 약된 성 원 
// Windows 에 예 약된 성 원 
// Windows 에 예 약된 성 원 


여 기서 특히 주목해 야 할 성 원은 rePaint 이 다. 이 성 원에 는 다시 그리 기 할 필요가 
있는 창문 령역의 자리표가 보관되여 있다. 이 정보를 리용하여 창문을 다시그리기하는 
시간을 단축할수 있다. 

가상참문의 다시그리기시간의 단축 

시 간단축의 요점 은 WM_PAINT 통보문을 받았을 때 rePaint 가 가리 키 는 창문의 일 
부 령역만을 다시 그리는것이다. 가상창문을 사용하면 이것을 간단히 실현할수 있다. 가 
상창문의 같은 령역을 물리창문에 복사하기만 하면 되기때문이다. 

두개의 장치상황은 동등한것이므로 자리표에 대해서도 마찬가지이다. rePaint 에서 
지정되는 자리표는 물러창문과 가상창문의 어느것에서나 사용할수 있다. 실례로 
WM_PAINT 통보문에 대한 응답을 아래와 같이 한다. 
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case WM_PAINT: // 다시 그리 기 요구의 처 리 (개 량판 ) 

hdc = BeginPaint(hwnd, &ps); // 장치 상황을 얻 는다 . 

// 가상창문의 일부를 복사한다 . 

BitBlt(hdc, ps.rcPaint.left ， ps.rcPaint.top ， 
ps. rcPaint. right - ps. rcPaint. left, // 너비 
ps. rcPaint. bottom - ps. rcPaint. top, 
memdc, 

ps. rcPaint. left, ps. rcPaint. top, 

SRCCOPY); 

EndPaint(hwnd, &ps) ； // 장치 상황을 해 제 한다 . 

break ； 

고친 효과를 확인하기 위해 이 프로그람코드를 앞절 에 서 작성한 프로그람의 해 당한 
부분과 치환한다. 개량된 프로그람코드에서는 rcPaint 에서 지정된 령역만을 복사하므로 
정보의 덧쓰기나 창문의 경계선을 벗어난 그러기가 진행되지 않으므로 시간을 랑비하지 
않는다. 

가상창문을 사용한 혜택으로 창문의 다시그리기의 최적화 7 ' 간단히 실현되였기때문 
이 다. 다시 그러 기 에 가상창문을 리 용하는 방법 은 다시그리기 와 관련된 많은 처 리 에서 
간결한 해결책을 제공해 준다. 

실험으로서 BeginPaint ( )를 호출한 다음에 아래와 같은 프로그람코드를 삽입하면 
WM _ PAINT 통보문을 받았을 때 필요한 다시그러 기령 역의 자리표를 확인할수 있다. 


sprintf(str, “top, left ： &d &d\nBottom, right : &d &d”, 
ps. rcPaint. top, ps. rcPaint. left, 
ps. rcPaint. bottom, ps. rcPaint. right) : 

MessageBox(hwnd, str, “coordinates”, MB_OK); 

str 는 문자의 배럴이다. 프로그람을 실행하고 창문의 두개 개소 혹은 그이상의 부분 
을 다른 창문에 가리우게 한다. 매 가리운 부분에 대해 통보문이 생성된다는것을 알수 
있을것 이 다. 

이 책의 대부분의 실례프로그람에서는 다시그리기의 최적화를 하지 않고 있다. 왜냐 
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하면 다시그리 기 를 위한 프로그람코드를 추가하면 실 례프로그람에 서 설 명하려 는 요점 이 
강조되지 않기때문이 다. 그러나 실제로 작성하는 프로그람들에서는 WM_PAINT 통보문 
을 적절하게 처 리하는것 이 성능에 커 다란 영향을 준다는것을 명심해 두어 야 한다. 

전용아이콘과 전용유표의 작성 


이 장을 마치 기 에 앞서 전용아이콘과 전용유^를 작성 하고 사용하는 방법 을 설명하 
기로 한다. 

알고 있는바와 같이 모든 Windows 2000 응용프로그람은 제 일 처음 창문의 속성을 정 
의 하는 창문콜라스를 작성 하며 창문클라스에 는 응용프로그람의 아이 콘과 마우스유표의 형 
태 도 포함되 여 있 다. 아이 콘과 마우스유표의 손잡이 는 P 犯 VDCL /1 SSE 포 구조체 의 hlcon , 
hlconSm 및 hCursor 라는 성 원에 보관된다. 지금까지는 Windows 2000 이 제공하는 내 장 
아이콘과 유표를 사용하여 왔다. 하지만 아이콘과 유표를 자체로 정의 할수도 있다. 

아이콘과 유표의 정의 

전용아이콘과 마우스유표를 사용하려면 그것들의 화상을 미 리 화상편집기를 사용하 
여 작성해 두어야 한다. 작은 아이콘과 큰 아이콘이 필요된다는것을 명심해 두어야 한다. 
작은 아이 콘의 크기 는 16 Z 16 화소이며 큰 아이 콘의 크기는 32 Z 32 화소이 다. 작은 아이 
콘과 큰 아이콘은 같은 아이콘파일안에 보관된다. 모든 유표의 크기는 같으며 32 X 32 화 
소이 다. 

이식과 관련한 요점 : 16 bit 의 Windows 에서는 큰 아이콘만을 정의한다. 

이제부터 작성 하게 될 프로그람에서는 아이콘을 보관하는 파일을 ICON.ICO 라는 
파일 이 름으로 작성한다. 반드시 32 / 32 화소와 16 Z 16 화소의 두개 의 아이 콘을 작성 해 야 
한다. 이 아이콘들은 또한 같은 파일에 보관하여 야 한다. 

유표를 보관하는 과일은 CURSOR . CUR 라는 이 름으로 작성 한다. 그림 7-5 에 이 장 
의 실례프로그람에서 사용하는 아이콘과 유표의 형 태를 보여 주었다. 

아 이 콘과 유표의 화상을 작성 한 다음에 는 프로그람의 자원 파일 에 ICON 말 
CURSOR 호\ 두 명령문을 추가해야 한다. 이 명령문들의 일반적인 서식은 다음과 같다. 
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^nrK Build 乂 Debug 乂 Find in File S | ， | | 니스 UZK Build / Debug \ Find in F 卜 | | 

Ready_ _匕 _r_ol_ R^dv_ 立 _^_ 인 _ 



그림 7-5. 전용아이콘과 전용유표 


IconName ICON filename 
CursorName CURSOR filename 

IconName 은 아이콘을 식별 하는 이름이며 CursorName 은 유표를 식 별하는 이름이 
다. 이 이름들은 프로그람에서 아이콘이 나 유표를 참조하는데 사용된다. filename 에는 
전용아이콘이나 전용유표를 보관하고 있는 파일의 이름을 지정한다. 

실례프로그람에는 아래의 명령문이 들어 있는 자원파일이 필요하다. 

MyCursor CURSOR CURSOR. CUR 
Mylcon ICON ICON. ICO 
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제 7 장. 비 트매프의 사용법과 다시그리기문제의 해결방법 


아이콘과 유표의 적재 

전용아이 콘과 전용유표를 사용하려 면 그것 들을 창문콜라스를 등록하기전에 적 재 하고 
2 장에서 설명 한 Loadlcon ( ) 및 LoadCursor ( ) 라는 API 함수를 사용 하여 
WMX 己구조체 의 성 원으로 설정 하여 야 한다. 

례 를 들어 아래 의 프로그람코드는 Mylcon 이 라는 이 름의 아이 콘 및 MyCursor 라는 
이 름의 유표를 적재 하고 그것들을 WNDCLASSEX 의 성 원에 설정한다. 

wcl.hlcon = Loadlcon(hThisInst , “Mylcon”); // 큰 아이콘 

wcl. hlconSm = NULL ； // Mylcon 에 보관된 작은 아이콘을 사용한다 . 
wcl.hCursor = LoadCursor(hThisInst, “MyCursor”); // 유표 

hThisInst 는 프로그람의 실체의 손잡이 이다. 지금까지 작성 해 온 프로그람들에서 는 
이 함수들이 체계설정의 아이콘이나 유표를 적재하는데 사용되였지만 여기에서는 전용아 
이 콘이 나 전용유표를 적 재하는데 사용되 고 있 다. 

hlconSm 에 NULL 을 설정 한데 주목해 야 한다. hlconSm 이 NULL 인 경 우에 는 큰 
아이콘을 보관한 파일안에 정의되여 있는 작은 아이콘이 자동적으로 적재된다. 다시말하 
여 hlconSm 이 NULL 이 라면 hlcon 에 설정된 큰 아이콘과 같은 파일 에 보관된 작은 아 
이콘이 설정되게 된다. 

물론 필요하다면 작은 아이콘에 다른 아이콘자원을 설정할수도 있다. 그러나 그렇게 
하자면 이 장의 맨 마감에 설 명 하는 LoadIimge () 합숙•를 사용해 야 한다. 일 반적 인 프로 
그람에서는 큰 아이콘이 보관된 파일에 작은 아이콘도 정의되여 있다. 

전용아이콘과 전용유표의 실례프로그람 

실 례 7-4 에 보여 준 프로그람은 전용아이 콘과 전용유표를 사용하는 프로그람이다. 
작은 아이 콘은 기 본창문의 체 계차림 표와 프로그람을 최 소화하였을 때 과제 띠 에 표시 된 다. 
큰 아이콘은 프로그람을 탁상면에 이동했을 때 표시된다. 

전용유표는 마우스지시자를 창문우에 놓았을 때 표시된다. 프로그람의 창문우에 마 
우스를 이동하면 마우스유표의 형태가 프로그람에서 정의된 형태로서 자동적으로 변한다. 
프로그람의 창문밖으로 마우스를 이동하면 마우스유표는 자동적 으로 체 계설정의 형 태로 
돌아간다. 

이 프로그람을 번역하기전에 화상편집기를 사용하여 전용아이콘과 전용유표를 작성 
하고 프로그람의 자원파일에 자원정의를 추가하여야 한다. 

실례 7-4. IconCursor 프로그람 


// 전용아이콘과 전용유표의 실례 
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#include < windows. h> 
ttinclude <cstring> 
■elude <cstdio> 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM); 
char szWinName[] = ，， MyWin”; // 창문클라스의 이름 

int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

// 창문클라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) : 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = Loadlcon(hThisInst, ” Mylcon”); // 큰 아이콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl. hCursor = LoadCursor (hThisInst, "MyCursor") ； // 유표 

wcl. IpszMenuName = NULL ； // 물라스차림표는 없다 . 
wcl.cbClsExtra = 0 ； // 보조기억기령역은 필요 없다 . 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 

// 창문클라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 

/* 창문들라스가 등록되였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문믈라스의 이름 
” Custom Icons and Cursor”, // 제목 

WS.OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
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CWJJSEDEFAULT, // X 자리 표는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림 표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메터는 없 다 . 

)； 


// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성한다 . 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage(Smsg) ; // Windows 2000 에 조종을 넘 긴다 . 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

switch (message) { 

case WM_DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) : 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam) : 

} 
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return 0 ； 

} 

작은 전용아이콘을 그림 7-6 에 보여 주었다. (물론 전용아이콘을 다른 모양으로 작 
성해도 상관 없다.) 전용유표는 창문우에 마우스를 가져갔을 때 표시된다. 



Load I mage ( 》의 사용 방 법 


앞서 본 실 례 프로그람들에 서 는 아이 콘과 유표를 적 재 하는데 LoadlconC ) 말 
LoadCursor( ) 를 사용하였 다. 비 트매 프의 화상을 적 재 하는데 는 LoadBitmap ( ) 를 사용 
하였다. 이 함수들은 초기의 Windows 에서부터 사용되 여 온것들이다. 이 함수들의 사 
용에서는 현재도 전혀 문제 가 없다. 그러 나 Windows 2000 은 이것들을 대신하여 더 편 
리 하게 사용할수 있는 LoadIimge( ) 타는 함수를 제 공하고 있 다. 

LoadlmageC ) 는 유연한 기능을 가진 함수로서 아이콘，유표 및 임의의 크기의 비 트 
매 프를 적재 하는데 사용되 며 더 우기 그것 들을 적재할 때 세 밀한 설정 을 할수도 있다. 실 
례 로 LoadImage( ；# 사용하여 큰 아이 콘의 파일 안에 정의 되 여 있는것 이 아닌 다른 작 
은 아이 콘을 적 재할수 있 다. 

이 책 의 실 례 프로그람들에 서 는 LoadlmageC )7 、 가지 는 기 능이 필 요되 지 는 않으므로 
함수의 기능에 대해서만 설명해 둔다. 

Loadlmagei ᄉ의 선언은 다음과 같다. 


HANDLE Loadlmage (HINSTANCE hThisInst , LPCSTR IpszName , 

UINT what , int width , int height , UINT how ); 

실체의 손잡이는 hThisInst 에 설정 한다. 적재 할 자원이름의 지시 자를 IpszName 에 
설정한다. what 의 값으로는 적재할 화상의 종류를 설정한다. 이것은 아래의 어느 한 값 
이 여 야 한다. 


224 


교육성 프로그람교육쎈터 








제 7 장. 비 트매프의 사용법과 다시그리기문제의 해결방법 


IMAGEJCON IMAGE_CURSOR IMAGE_BITMAP 


화상의 너비와 높이를 width 와 height 에 설정한다. how 에는 화상의 적재방법을 
지시하는 값을 설정하며 다음의 두개의 값이 자주 사용된다. 

LR_DEFAULTSIZE LR_LOADFROMFILE 


LR_DEFAULTSIZE A 설정 되고 width 와 height 가 령 인 경우는 아이콘과 유표의 
표준적 인 크기가 너 비와 높이로서 리용된다. LR_DEFAULTSIZE 가 설정되여 있지 않고 
width 와 height 가 령인 경우는 실제 화상의 크기가 그대로 너비와 높이로 리용된다. 
LR_LOADFROMFILE 이 지정된 경우는 IpszName 이 자원파일안에 정의된 자원의 이름 
이 아니라 화상이 보관된 파일자체의 이름을 가리키는것으로 된다. 

LoadImage() 는 호출이 성공하면 화상의 손잡이를 돌려 주며 오유가 발생한 경우에 
는 NULL 을 돌려 준다. 

Loadlmage () 의 기 능을 시 험 해 보기 위 해 제 일 처 음 작성 한 비 트매 프의 실 례 프로그 
탐에 서 WM_CREATE 를 처 리 하는 부분을 아래 의 프로그람코드로 바꾸어 보자. 

hbit = (HBITMAP) Loadlmage(hlnst, “MyBP”, IMAGE_BITMAP, 256, 128, 0); 

프로그람의 동작은 달라 지지 않는다는것을 알게 될것이다. 이번에는 비트매프의 크 
기 를 변경 해 보자. 례 를 들어 126 Z 64 로 변경하여 결과를 확인해 보면 비 트매 프의 일부 
만이 적재되는것을 보게 된다. 

LoadlmageC) 를 사용하면 프로그람에서 화상을 적재할 때 세밀한 조종을 할수 있으 
나 이 책의 실례프로그람들에서는 그러 한 기능들을 필요로 하지 않으므로 다음 장부터는 
LoadlmageC )를 사용하지 않는다. 
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Windows 2000 은 창문의 의뢰자구역에 본문을 출력하기 위한 세밀한 조종을 
할수 있는 세련된 기능들을 제공하고 있다. 

앞장들에서는 본문을 출력하는데 가장 기초적 인 방법만을 리용하였다. 

실례로 행간격이나 문자간격으로는 적당한 값이나 고정된 값을 리용하였다. 
물론 이 수법은 사실 정확치 못한 방법 이 다. 왜 냐하면 Windows 2000 에서는 비 
례적기호서체가 사용되며 서체의 크기를 변경할수 있기때문이 다. 

이 장에 서 는 본문의 출력 을 조종하기 위 한 정 확한 방법 에 대 해 설 명한다. 

Windows 2000 에서는 다른 많은 요소와 마찬가지로 프로그람작성자들이 본문 
의 출력에 있어서 그의 크기, 무게 및 서체형 등의 설정을 거의 제한없이 조종할수 
있다. 필요한 서체의 종류를 선택하고 그것을 필요에 따라 변경시킬수도 있다. 또 
한 본문의 기초선의 방향을 변경시켜 수평방향으로만이 아니라 경사 또는 수직방향 
으로 표시 할수도 있다. 

물론 본문출력 에 대 한 고급한 조종을 실현하려면 그만한 노력 이 필요하게 된 
다. 프로그람에 서 진행해 야 하는 처 러량은 상상밖으로 많아 지 게 된 다. 그러 나 
얻어지는 결과는 기울인 노력 에 충분히 맞먹는것 으로 된다. 

이 장에서는 먼저 창문의 자리표계와 본문을 넘 기기하는 방법 에 대 해 설명한 
다. 다음 창문의 의뢰자구역에로의 본문출력을 조종하는데 사용되는 몇가지 API 
함수를 설 명한다. 그 함수들의 사용방법 과 의 뢰 자구역 에 적 절 한 간격 으로 본문을 
표시하는 방법 을 보여 주는 실례프로그람을 작성한다. 또한 이 장에 서 는 
Windows 가 본문의 서체를 취급하는 방법에 대해서도 설명한다. 
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참문의 자리표 


Window 에 는 TextOutC ) 라는 본문출력 함수가 있다. 이 함수는 항상 창문에 대 한 
상대적인 자리표를 지정하여 문자렬을 표시한다. 그러므로 화면상의 어느 위치에 창문이 
있어도 TextOut () 에 보내는 자리표에는 영향이 없다. 체계설정으로 창문의 의뢰자구역 
의 왼쪽웃모서 리가 자리표원점 인 (0， 0) 으로 된다. X 자리표의 값은 창문의 오른쪽으로 
가면서 증가하며 Y 자리 표의 값은 창문의 밑 으로 내 려 가면서 증가한다. 

지 금까지 는 TextOut ( ) 에 지 정 하는 창문의 자리 표를 그것 이 실제로 어떻게 정의 되 
는가를 생각하지 않고 사용하였다. 그러므로 여기서 몇가지 개념을 명백히 하자. 우선 
TextOut ( ) 에서 사용되는 자리표는 론리자리표이라는것이다. 이것은 TextOut ( ) 또는 
다음 장에서 설명하는 도형함수들을 비롯한 다른 표시 함수들에서 사용되는 단위가 론리 
단위 라는것 이 다. 

Windows 는 출력내용을 실제로 화면에 표시 할 때 론리 단위를 화소단위로 넘기기 한 
다. 이 러한 차이를 구별하지 않아도 문제가 생기지 않은것은 체계설정으로는 론리단위가 
화소단위와 같게 되여 있기때문이다. 그러나 이 편리한 체계설정이 아니라 다른 넘기기 
방식 이 사용되는 경우도 있다. 

본문과 배경색의 설정 


TextOut ( )를 사용하여 창문에 본문을 출력하면 체계설정으로는 현재의 배경색의 우 
에 검 은색 으로 본문이 표시 된다. 그러 나 SetTextColorC ) 및 SetBkColor( ) 라는 API 함수 
를 사용하면 본문과 배경의 색을 설정할수 있다. 이 함수들은 다음과 같이 선언되였다. 


COLORREF SetTextColor(HDC hdc , COLORREF color ); 


COLORREF SetBkColor(HDC hdc , COLORREF color ); 


SetTextColor () 는 hdc 에서 지정된 장치의 본문색을 color 에서 지정된 색 (혹은 장 
치가 표시할수 있는 색중에서 제일 류사한 색)으로 설정한다. SetBkColor ( ) 는 본문의 
배경을 color 로 지정된 색 (혹은 가장 가까운 색)으로 설정한다. 두 함수는 바로 전에 
설정되여 있던 색을 돌림값으로서 돌려 준다. 오유가 발생한 경우는 CLRJNVALID 라는 
값을 돌려 준다. 
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색은 COLORREF 형느로 지정 한다. 이것은 32 bit 의 옹근수값이 다. Windows 2000 
에서 색을 지정하는데는 세가지 방법 이 있다. 

첫번째 방법은 RGB (적，록, 청)값을 사용하는것이다. 이것은 가장 일반적인 방법 
이 다. RGB 의 값은 세 가지 색 의 농도가 혼합된 색 을 지 정한다. 두번째 방법 은 론리 조색 
판의 색 인을 사용하는것 이 다. 세번째 방법은 조색판의 RGB 값을 사용하는것 이 다. 이 장 
에서는 첫번째 방법에 대해서만 설명하기로 한다. 

RGB 색 을 보관하기 위 한 긴 정 수값 ( COLORREF ) 은 아래 와 같이 부호화되 여 그것 
이 SetTextColorC ) 및 SetBkColorC ) 에 전달된다. 




byte 0(제일 아래 byte ) 

붉은색 

byte 1 

푸른색 

byte 2 

풀색 

byte 3 (제 일 웃 byte ) 

령이여야 한다. 



RGB 의 세 가지 색은 각각 0〜255 의 범위 에서 값을 설정 할수 있으며 0 은 가장 희 
박한 농도를，況5는 가장 짙 은 농도를 가리킨다. 

직접 COLORREF 의 값을 작성해도 상관이 없지만 Windows 는 그 작업을 자동화 
하여 주는 及 G 公 ( 고마크로를 정의 하고 있다. 다음에 서식 을 보여 주었 다. 

COLORREF RGB (BYTE red , BYTE green , BYTE blue ); 

red , green 및 blue 의 값은 0 〜 255 의 범위에 속해야 한다. 그러므로 밝은 분홍색을 
작성하려면 RGB (255, 0, 255) 를 사용하면 된다. 흰색을 작성한다면 RGB (255, 255, 255) 
를 사용한다. 검은색을 작성한다면 RGB (0, 0, 0) 을 사용한다. 그밖의 색을 작성한다면 세 
가지 기본색의 농도를 설정하고 그것들을 조합한다. 실례로 RGB (0, 100, 100) 은 밝은 물 
색을 작성한다. 실제로 시험해 보고 어떤 색이 응용프로그람에 적당한가를 결정하시오. 


배경현시방식의 설정 


SetBkMode ( ) 타는 API 함수를 사용하면 화면 에 본문이 표시 되 는 때 의 배 경 방식 을 
조종할수 있다. 선언은 다음과 갈다. 


int SetBkMode (HDC hdc , int mode ) : 


이 함수는 본문 또는 다른 어떤 출력이 표시될 때 배경을 어떻게 표시하는가를 지정 
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한다. 장치상황의 손잡이를 hdc 에 설정한다. 배경방식을 mode 에 설정한다. : mode 의 값 
으로는 OPAQUE 1 는 TRANSPARENT 중아 사 어 느 하나를 설 정 한다. 이 함수는 바로 
전에 설정되여 있던 값을 돌려 주며 오유가 발생한 경우에는 령을 돌려 준다. 

mode 가 OPAQUE 인 경우에 본문이 출력되면 배경이 현재의 배경색으로 변한다. 
mode 가 TRANSPARENT 인 경 우 에 는 배 경 이 변 하 지 않 는 다 . 이 경 우 에 는 
SetBkColorC )로 설정한 배경색 이 무시된다. 체계설정의 배경방식은 OPAQUE 이 다. 


본문치수의 얻기 


Windows 에서는 모든 본문의 서제 A 비례적인것으로 되여 있으며 문자의 크기도 
다르다. 실례로 “ i ” 라는 문자는 “ w 5 , 라는 문자와 너비가 다르다. 매 문자의 높이와 디센 
더 (기초선아래의 부분)의 길이도 서체에 따라 다르다. 기초선의 간격도 변경할수 있게 
되여 있다. 

Windows 는 창문의 의뢰자구역 에 본문을 출력하는 기능을 가진 함수를 몇종류밖에 
제 공하지 않고 있 다. 주요한 함수는 지 금까지 사용해온 TextOut ( ) 함수이다. 이 함수 
에는 한가지 기능밖에 없다. 지정된 위치에 문자렬을 표시하는것 이 다. 례하면 출력서식 
을 설정하거나 복귀 및 개행을 자동적으로 처리하는 기능 등은 가지고 있지 않다. 그러 
므로 필요한 처리는 모두 프로그람작성자들이 해야 한다. 

매 문자의 크기가 다르다는것과 프로그람의 실행중에 서체의 종류를 변경할수 있다 
는 점으로부터 현재 선택되여 있는 서체의 크기나 다른 속성을 알아내는 방법이 필요하 
게 된다. 실례로 행을 바꾸어 문자렬을 출력하려면 서체의 높이와 행간의 화소수를 알기 
위한 어떠한 방법이 필요하게 된다. 

현재의 서체정보를 엄는 API 함수는 GetTextMetrics(M 다. 아래 에 선언을 보여 주 
었 다. 

BOOL GetTextMetrics (HDC hdc , LPTEXTMETRIC lpTAttrib ) : 

hdc 는 출력 장치 의 손잡이이 며 일 반적 으로 GetDCC ) 나 BeginPaintC ) 로 얻 는 다. 
IpAttrib 는 TEXTMETRIC 구조체의 지시 자이 다. 이 구조체 에 는 현재 선택되 여 있는 본 
문치수가 돌려 진다. 아래에 7五포7次紀:7次/ C 구조체의 정의를 보여 주었다. 

typedef struct tagTEXTMETRIC 

{ 


LONG tmlnternalLeading : 


LONG tmHeight ； 
LONG tmAscent ； 
LONG tmDescent ； 


// 서체의 전체 높이 
// 기초선의 높이 
// 디센더의 길이 
// 기호의 웃부분의 간격 


교육성 프로그람교육멘터 


229 




Windows 2000 프로그람작성법 


LONG tmExternalLeading; 
LONG tmAveCharWidth 
LONG tmMaxCharWidth 
LONG tmWeight ； 

LONG tmOverhang ； 

LONG tmDigitizedAspectX ； 
LONG tmDigitizedAspectY ； 
LONG tmFirstChar ； 

LONG tmLastChar ； 

LONG tmDefaultChar ； 
LONG tmBreakChar ； 

LONG tmltalic ； 

LONG tmUnderlined ； 
LONG tmStruckOut ； 

LONG tmPitchAndFamily ； 
LONG tmCharSet; 


// 행간의 빈 간격 
fi 평균너비 
// 최대너비 
■ 무게 

// 특수한 서체에 추가되는 너비 
// 수평 비률 
// 수직 비률 
// 서체의 선두 문자 
// 서체의 마지막 문자 
// 체계설정의 문자 
// 단어를 끝내는 문자 
// 경사체이면 령 아닌 값 
// 밑선이 있으면 령 아닌 값 
// 취소선이 있으면 령 아닌 값 
// 서체의 간격과 계렬 
// 문자모임의 식별자 


다시 한보 전진 


NEWTEXTMETRIC 오유 NEWTEXTMETRICEX 

TEXTMETRIC 를 확 장 한 NEWTEXTMETRIC 라 는 구 조 체 가 있 다 . 
NEWTEXTMETRICEX 는 TEXTMETRIC 의 마감에 4개의 성원을 추가한것이다. 
추가된 성원들은 TrueType /-////# 지원하기 위한것들이다. (TrueType 서체는 우 
수한 확대축소 ( scalibility ) 기능을 제공한다. ) NEWTEXTMETRIC 에 추가된 성 
원들은 다음과 갈다. 

DWORD ntmFlags ； 

UINT ntmSizeEM ； 

UINT ntmCellHeight ； 

UINT ntmAvgWidth ； 


// 서체의 형식을 가리킨다. 
// “…’이라는 기호의 크기 
// 서체의 높이 
// 평균너비 


NEWTEXTMETRIC 의 확장판으로서 최근 Win 32 에 추가된 구조체에 
NEWTEXTMETRICEX 라는것도 있다. 정의는 다음과 같다. 


typedef struct tagNEWTEXTMETRICEX 

{ 
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NEWTEXTMETRIC ntmTm ； 

FONTSIGNATURE ntmFontSig ； // 서체서명 
} NEWTEXTMETRICEX; 

NEWTEXTMETRICEX 는 NEWTEXTMETRIC 에 FONTSIGNATURE 구조 
체 를 추가한것 이 다. FONTSIGNATURE 구조체 는 유니 코드와 코드페 지 에 대 한 정 
보를 보관한다. 

이 장에 서 는 NEWTEXTMETRIC 나 NEWTEXTMETRICEX 에 추가된 성 원 
들을 필요로 하지 않는다. 그러 나 실제 적 인 프로그람들에서 는 이 것들이 가치있는 
것으로 될것 이 다. 


GetTextMetrics ( ) 에서 얻은 대부분의 값들은 이 장에서 쓰이지 않지만 본문의 기 
초선의 간격을 계산하는데 필요되는 두개의 값은 매우 중요하다. 행 간 간격은 창문에 한 
행 이상의 본문을 출력 하려는 경우에 필요하게 된다. 

서체가 한가지뿐이고 그 크기가 고정되여 있는 조종탁 ( Console ) 프로그람과는 달리 
Windows 에는 여러가지 종류의 서체가 있으며 그의 크기를 변경시킬수도 있다. 매개 
서체는 문자의 높이와 행간격을 정의하고 있다. 그러므로 사전에 본문행사이의 적절한 
수직거 리 ( Y ) 를 아는것 은 불가능하다. 

본문의 다음 행의 표시위 치를 결정하려면 GetTextMetrics ( ) 를 호출하여 tmHeight 
및 tmExternalLeading 의 두개의 값을 엄어야 한다. 이 값들에는 문자의 높이 및 행사 
이에 배치해야 할 공백간격이 보관된다. 이 두개의 값을 더하여 본문의 행간격을 구할수 
있 다. 

tmExternalLeading 에는 본문의 행사이 에 놓이는 공백 값만이 보관되여 있다는데 주 
의해야 한다. 이 값은 서체자체의 높이와는 다르다. 행의 전체 높이를 계산하려면 항상 
두 값이 펼요하게 된다. 

문자렬의 길이를 구하기 

Windows 는 본문유표를 자동적으로 조종하거 나 현재의 표시위 치를 관러하는 일은 
해 주지 않는다. 그러므로 같은 행에서 문자를 련속 표시하려면 바로 전의 출력에서 마 
감위치를 기록해 둘 필요가 있다. 그러므로 문자렬의 길이를 론리단위로 알기 위한 어 
떤 방법이 필요하게 된다. 

대부분의 서체에서는 매개 문자가 같은 크기로 되여 있지 않으므로 단순히 문자수만 
알고서는 문자렬의 길이를 론리단위로 알수 없다. 다시말하여 매 문자의 너비가 다르므 
로 창문의 표시 위 치를 결정 하는데 strlen ( ) 를 사용할수 없 다. 

이 문제 를 해 결 하기 위 해 Windows 2000 은 GetTextExten 任 3 oint 32( ) 라는 API 함수 
를 제공하고 있다. 아래에 선언을 보여 주었다. 
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BOOL GetTextExtentPoint 32 (HDC hdc , LPCSTR IpszString , int len , 

LPSIZE IpSize ) : 

hdc 는 출력장치의 손잡이 이다. 길 이를 알려는 문자렬을 IpszString 에 설정 한다. 문 
자렬의 길이를 len 에 설정한다. 문자렬의 너비와 높이는 론리단위로 돌려 지며 IpSize 
가 가리키는 SIZE 구조체 에 보관된다. 아래 에 57 ZE 구조체의 정의를 보여 주었다. 

typedef struct tagSIZE { 

LONG cx ； // 너 비 

LONG cy ； // 높이 

} SIZE ； 

GetTexffixtentPoint 32() 의 돌림값의 cx 성원에는 문자렬의 너비가 보관되여 있다. 
표시된 문자렬의 마감위치를 판정하기 위해 이 값을 사용할수 있다. 같은 행에 문자렬을 
표시하는 경 우에 는 바로 전에 출력 된 문자의 마감위 치 에서 부터 계속해 나가면 된다. 
GetTextExtentPoint 32 ( ) 는 호출이 성 공하면 령 아닌 값을 돌려 주며 실 패 하면 령 을 
돌려 준다. 


이식과 관련한 요점 : GetTextExtentPoint 32( ) 는 Windows 3.1 프로그람에서 사용되 
고 있는 낡은 16 bit 함수인 GetTextExtent ( ) 를 대신하는 함수이다. 


본문의 간단한 실례 


실례 8-1 에 보여 준 프로그람은 본문의 출력 과 지금까지 설명한 본문과 관련된 함 
수들의 실례 를 보여 주는 프로그람이다. WM_PAINT 통보문을 받으면 기 본창문의 의 뢰 
자구역에 여러 행의 본문이 표시된다. 

실 례 8-1. Text 프로그람 


// 본문출력의 관리 
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ttinclude 〈 windows. h> 
ttinclude <cstring> 
ttinclude <cstdio> 
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LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) : 

char szWinName[] = ” My Win”; // 창문믈라스의 이름 

char s 比 [255]: // 출력할 문자렬을 보관한다. 
int X=0, Y=0; // 현재의 출력위치 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

// 창문물라스를 정의 한다. 

wcl. cbSize = sizeof (WNDCLASSEX) : 


wcl.Mnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문콜라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이 콘 

wcl. hlconSm = NULL ； // 큰 아이론의 축소판을 사용한다 . 

wcl. hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl. IpszMenuName = NULL ； // 믈라스차림표는 없다 . 
wcl.cbClsExtra = 0; // 보조기억기령역은 필요 없다 . 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) : 

// 창문콜라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문콜라스가 등록되 였으므로 
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창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Managing Text Output", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 너비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 높이 는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

)； 


// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode) : 

UpdateWindow (hwnd) : 

// 통보문순환고리를 작성 한다 . 

while(GetMessage (&msg, NULL, 0, 0)) 

f 

TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage(Smsg) : // Windows 20M 에 조종을 넘 긴다 . 

} 

return msg.wParam; 


/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 

TEXTMETRIC 加 ; 

SIZE size ； 

PAINTSTRUCT paintstruct ； 
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switch (message) { 
case WM_PAINT: 


hdc = BeginPaint (hwnd, Spaintstruct) : 


// 본문치수률 엄는다 . 


GetTextMetrics (hdc, 技 tm); 


X = Y = 0 ； 

sprintf (str, ” This is on the first line."); 

TextOut(hdc, X, Y, str, strlen(str)) : 

Y = Y + tm. tmHeight + tm. tmExternalLeading ； // 행 바꾸기 한다 . 

strcpy(str, ” This is on the second line. ”) ; 

TextOut(hdc, X, Y, str, strlen(str)) ； 

Y = Y + tm.tmHeight + tm. tmExternalLeading ； // 행 바꾸기 한다 . 

strcpy(str, ” This is on the third line. "); 

TextOut (hdc, X, Y, str, strlen(str)) ； 

// 문자렬의 길 이률 구한다 . 

GetTextExtentPoint32 (hdc, str, strlen(str), &size) ； 
sprintf(str, ” The preceding sentence is %ld units long", 
size, cx); 

X = size.cx; // 바로 전의 문자렬의 마감위치로 간다 . 

TextOut (hdc, X, Y, str, strlen(str)) ； 

Y = Y + tm.tmHeight + tm. tmExternalLeading ； // 개 행 한다 . 

X = 0 ； // 행의 선두위치로 복귀한다 . 

sprintf (str, ” The space between lines is %ld pixels.", 
tm. tmExternalLeading+tm. tmHeight) ； 

TextOut (hdc, X, Y, str, strlen(str)) ； 

Y = Y + tm.tmHeight + tm.tmExternalLeading ； // 개 행 한다 . 


sprintf(str, "Average character width is %ld pixels”, 
tm. tmAveCharWidth); 

TextOut (hdc, X, Y, str, strlen(str)) ； 

Y = Y + tm.tmHeight + tm.tmExternalLeading ； // 개 행 한다 . 


// 본문색을 붉은색으로 한다 . 
SetTextColor(hdc, RGB (255, 0, 0)); 
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// 배경색을 푸른 색으로 한다 . 

SetBkColor(hdc, RGB(0, 0, 255 ))； 

sprintf (str, "This line is red on blue background. ’’) ； 
TextOut(hdc, X, Y, str, strlen(str)) ； 

Y = Y + tm. tmHeight + tm. tmExternalLeading ； // 개 행 한다 . 

// TRANSPARENT 방식 으로 변경 한다 . 

SetBkMode(hdc, TRANSPARENT) ； 
sprintf (str, 

"This line is red. The background is unchanged. ’’); 
TextOut(hdc, X, Y, str, strlen(str)) ； 

EndPaint (hwnd, &paintstruct) ； 
break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 

} 

return 0 ； 

} 

이 프로그람의 실행결과를 그림 8-1 에 보여 주었다. 


: j 旦]」 

This is on the first line. 

This is on the second line. 

This is on the third line. The preceding sentence is 157 units long 
The space between lines is 16 pixels. 

Average character width is 7 pixels 

This line is red. The background is unchanged. 


그림 8-1. 본문을 출력하는 실례프로그람의 실행결과 
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그러 면 프로그람의 내 용을 자세 히 설명해 보자. 우선 두개의 대 역 변수 X 와 Y 가 
선언되고 그것들이 령으로 초기화되고 있다. 이 변수들은 본문의 현재표시위치를 보관한 
다. 변수값은 출력이 진행될 때마다 갱신된다. 

이 프로그람에서 중요한 부분은 대체로 WM_PAINT 통보문안에 있다. WM_PAINT 
통보문을 받으면 장치상황이 얻어지 고 또한 본문치수가 얻 어 진다. 다음 제 일 첫행 의 본 
문이 출력 된 다. 이 본문은 sprintf ( 샷를 사용하여 작성 되 며 TextOut ( 고를 사용하여 출력 
된 다. 

TextOut ( ) 에 는 본문의 서 식을 설정 하는 기능이 없으므로 미 리 출력 내 용을 작성해 
두어 야 한다. 문자렬 이 표시 되 면 서체의 높이 와 행 간격 을 더 하여 Y 자리표를 다음 행 으 
로 옳긴다. 

계속하여 프로그람은 “This is on the second line .” 및 “This is on the third line .” 
라는 문자렬을 한 행씩 출력한다. 이때 세번째 행의 문자렬의 길이가 GetTextExtent 
32( )를 사용하여 엄어 진다. 이 값은 다음의 문자렬을 표시하기전에 바로 전의 문자렬 
의 마감위 치 에 X 자리 표를 옮기 는데 사용된 다. 

여 기서는 Y 자러표를 변경시키지 않으므로 다음 문자렬 이 마지막으로 표시된 문자렬 
의 끝에 련결되여 표시되며 개행이 진행되지 않는다. 다음 문자렬을 표시하기전에 프로 
그람은 Y 자리 표를 다음 행 으로 옮기 고 X 자리 표를 왼쪽 한계 자리 표인 령 으로 재 설정한 
다. 이렇게 되여 제일 첫행의 출력과 마찬가지로 복귀와 개행이 진행된다. 

다음 현재 선택되여 있는 서체와 관련된 몇가지 정보가 표시된다. 또한 배경색을 청 
색으로 설정하고 본문을 적색으로 설정하고 나서 문자렬을 표시한다. 마지막으로 배경방 
식을 TRANSPARENT 로 설정한 다음 문자렬을 표시한다. 이 경우에는 청색의 배경색 
이 무시된다. 


서체의 조종 


Windows 2000 및 Windows 전반에서는 사용자대면부의 거의 모든 부분을 프로그람 
에서 자유로이 조종할수 있게 되여 있다. 고도로 풍부한 본문조종기능을 제공하고 있는 
것도 그의 한 실례이다. 

본문조종기능의 하나로서 여러가지 종류의 서체가 제공되고 있다. 응용프로그람에서 
사용되는 서체를 조종하여 다른 프로그람과 구별되는 독특한 외형을 가진 응용프로그람 
을 작성할수 있다. 

Windows 2000 에는 몇개의 내장서체 A 있으며 전용서체를 작성할수도 있다. 여기에 
서는 서체의 조종기능을 설명한다. 우선 몇가지 용어의 의미부터 설명해 보자. 
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서체, 서체계렬，서체형 및 형식 


일반적으로 서제한 문자모임 말 그것들이 가지는 외형을 의미한다. 일반적으로 사용 
되는 서체 에는 여 러가지 종류가 있다. 실례 로 Courier 나 Times Roman 등은 가장 대중 
적 인 서체 이다. 

서체 에는 4 가지 속성 이 있다. 문자모임 , 서체형, 형식 말 크7/이 다. 여기서 그것들 
의 의미에 대해 설명하기로 하자. 

Windows 2000 은 여 러 가지 문자모임 을 제 공하고 있 다. 보통 사용되 는것 은 
Windows 의 표준문자모임 이 다. 이 문자모임은 ANSI 문자모임 에 기초하고 있으므로 매 
기 호는 8 bit 로 구성 되며 서 유럽의 많은 언어 들에 활용할수 있다. 

이밖에도 Windows 가 제공하고 있는 문자모임에는 Unicode , OEM (Original 
Equipment Manufacturer ) 및 특수기호(수식의 표기 에 사용되는 기호문자의 모임)가 
있 다. 

전용의 문자모임도 사용할수 있다. 

서체형 ( Type face ) 은 서체의 문자형태와 도안을 정의한다. 다시말하여 서체형은 
서체의 고유하고 시각적인 특징을 결정한다. 

일반적으로 서체의 형식이란 서체가 표준체，굵은체 혹은 경사체중 어느것으로 표시 
되는가를 지정 하는것 이 다. Windows 에서는 서체의 굵기를 아주 세밀하게 조종할수 있으 
므로 서 체 의 굵기 를 계 단식 으로 설 정 할수 있 다. 

서체의 크기는 1/72 inch 를 의미하는 포2/트단위로 지정된다. Windows 는 형태에 
따라 서체를 다섯개의 계렬1 분류하고 있다. 서체계렬의 종류에는 Decorative , 
Modern , Roman , Script 및 Swiss 가 있 다. 

Decorative 계렬의 서체는 특수한 서체이다. Modern 계렬의 서체는 비례서체가 아 
니 다. Roman 계 렬의 서체는 비례서체이며 본엄/선 ( Serif ) 을 가지고 있다. (받침선이 란 문 
자의 끝에 붙어 있는 작은 장식선이다.) Script 계렬의 서체는 손으로 쓴 글자같은 형태 
를 취하고 있다. Swiss 계 렬의 서체는 비례서체이며 받침선이 없다. 

비례서체에서는 매개 문자의 너비와 간격이 가변형으로 되여 있다. 비례서체를 가변 
간격서체타히 부른다. 비례서체가 아닌 서체에서는 매개 문자의 너비가 같다. 이것들 
을 고정간격서제 도는 고정 령 역 ( Monoscope ) 서 체 라고도 부론다. 

주사선，백토르 및 TrueType 서체 

Windows 2000 은 서체 를 보관하고 표시 하기 위 한 4 가지 방법을 제공하고 있다. 그 
것 들은 각각 주사선 ，벡 토르， TrueType 및 OpenType 라고 부론다. 

주사선서체는 서체내에 매 문乂/혹/ ( Glyph ) 을 비트매프로서 보관하고 있다. 표시방법 
은 간단하지만 확대 , 축소를 원만하게 할수 없다. 주사선서체는 현시장치나 인쇄기에 출 
력할 때 가장 잘 사용된다. 

의/토르서체는 매개 문자획을 형성하는 선분정보를 보관한것이다. 문자를 표시할 때는 
이 선분들이 그러진다. 작도기를 사용하는 경우에는 벡토르서체가 가장 리상적이다. 
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Truerj/pe 서체는 확대, 축소를 원활하게 할수 있는 서체이 다. 현시 장치의 표시 내용 
을 인쇄기출력으로 정확하게 변환할수도 있다. 이런 리유로부터 TrueType 서체는 탁상 
출판 분야의 응용프로그람에서 잘 사용되고 있다. OpenType 서체는 PostScript 형식의 
문자획 의 정 의 를 지 원하는 TrueType 서 체 의 일 종이 다. 


내 장서체 의 사용 방 법 


Windows 2000 의 내장서제는 GetStockObject () 를 러 용하여 선택 하는 내 장객 체 이 다. 
Windows 2000 은 7 개의 내장서체를 제공하고 있다. 

아래 에 서체의 종류를 가리키는 마크로들을 표시하였다. 


ANSI FIXED FONT 

고정 간격 서 체 

ANSI VAR FONT 

가변간격서체 

DEVICE DEFAULT FONT 

체계설정의 장치서체 

DEFAULT GUI FONT 

체계설정의 GUI 서체 

OEM FIXED FONT 

OEM 서체 

SYSTEM FONT 

Windows 2000 이 사용하는 체계서체 

SYSTEM _ FIXED_FONT 

낡은 판본의 Windows 가 사용하는 체계서체 


제계서제는 Windows 2000 이 차림표나 대화칸에서 사용하는 서체 이다. 낡은 판본의 
Windows 에서는 고정간격체계의 서체를 사용하였으나 Windows 3.0 부터 가변간격의 체계 
의 서체 가 사용되게 되 였다. Windows 2000 에서도 가변간격체계의 서체가 사용되 고 있다. 

내 장서체 를 선택하여 사용하는 방법 은 간단하다. 우선 HFONT 형 의 서 체 손잡이 를 
선언한 다음 서 체의 손잡이를 돌려 주는 API 함수인 GetStockObject () 를 리 용하여 목적 
하는 서체를 적재한다. 

서체를 변경 하자면 과라메터 에 새로운 서체를 지정한 SelectObjectC ) 를 호출하여 서 
체를 선택한다. SelectObject ( ) 는 바로 전에 선택되여 있었던 서체의 손잡이를 돌려 주 
므로 그 값을 보관해 두면 후에 본래의 서체 로 복귀할수도 있다. 

실례 8-2 의 프로그람코드는 서체를 변경하는 실례 이 다. 이 프로그람에서는 다시그 
리 기 를 진 행 하는데 제 7 장에 서 설 명 한 가상창 술을 사용하고 있 다. 


실 례 8-2. BuiMnFont 프로그람 


// 내장서체의 실례 
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#include < windows. h> 
ttinclude <cstring> 

^include <cstdio> 

#include ’’text.h" 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 

char szWinName[] = "MyWin" ； // 창문믈라스의 이름 

char str[255] ； // 출력 할 문자렬 을 보관한다 . 

int X=0, Y=0 ； // 현재의 출력위 치 

int maxX, maxY ； // 화면의 크기 

HDC memdc ； // 가상장치의 손잡이를 보관한다 . 

HBITMAP hbit ； // 가상비트매 프를 보관한다 . 

HBRUSH hbrush ； // 붓의 손잡이를 보관한다 . 

HFONT holdf, hnewf ； // 서체의 손잡이를 보관한다 . 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 

// 창문믈라스률 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ； 


wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ； // 큰 아이 콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC.ARROW) ； // 유표의 형 식 
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wcl. IpszMenuName = "FontMenu"; II 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기억기령역은 필요 없다 . 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 

// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


A 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow( 
szWinName, // 창문믈라스의 이름 
"Using Built-in Fonts", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자리 표는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 높이 는 Windows 가 결 정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림 표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메터는 없 다 . 

)； 


// 건반가속기를 적재 한다 . 

hAccel = LoadAccelerators(hThisInst, "FontMenu") : 

// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) ; 

UpdateWindow (hwnd ); 


II 통보문순환고리를 작성한다 . 
while(GetMessage(&msg , NULL, 0, 0)) 
{ 
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if( ! TranslateAccelerator(hwnd, hAccel, &msg)) { 
TranslateMessage(&msg) ； // 건반통보를 변환한다 . 
DispatchMessage(tosg) ; // Windows 2000 에 조종을 넘 긴다 . 

} 


return msg. wParam ； 

} 


/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 

PAINTSTRUCT paintstruct ； 
static TEXTMETRIC tm ； 

SIZE size; 

static fontswitch = 0 ； 
int response ； 


switch (message) { 
case WM_CREATE: 

// 화면의 크기를 얻는다 . 

maxX = GetSystemMetrics(SM_CXSCREEN) ； 

maxY = GetSystemMetrics(SM_CYSCREEN) ； 

// 가상창문을 작성 한다 . 

hdc = GetDC(hwnd) ； 

memdc = CreateCompatibleDC(hdc) ； 

hbit = CreateCompatibleBitmap (hdc, maxX, maxY) ； 

SelectObject(memdc, hbit); 

hbrush = (HBRUSH) GetStockObject(WHITE_BRUSH); 
SelectObject (memdc, hbrush) ； 

PatBlt(memdc, 0, 0, maxX, maxY, PATCOPY); 

// 새로운 서체률 얻는다 . 

hnewf = (HFONT) GetStockObject(ANSI_VAR_FONT) ； 
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ReleaseDC (hwnd, hdc); 
break； 

case WM.COMMAND： 
switch (LOWORD (wParam)) { 
case IDM_SHOW： 

// 본문색을 검은색 으로, 배 경 방식은 TRANSAPARENT 로 설정 한다. 
SetTextColor (memdc, RGB(0, 0, 0)) ； 

SetBkMode(memdc, TRANSPARENT) ； 


// 본문치수률 얻는다. 


GetTextMetrics (memdc, &tm) ； 


sprintf(str, "The font is %ld pixels high.’’, 
tm. tmHeight); 

TextOut(memdc, X ， Y, str, strlen(str)) ； 

Y = Y + tm. tmHeight + tm. tmExternalLeading ； // 개 행 한다 . 

strcpy(str, ” This is on the next line. 

TextOut (memdc, X, Y, str, strlen(str)) ； 

// 문자렬의 길이를 구한다 . 

GetTextExtentPoint32 (memdc, str, strlen(str), &size) ； 
sprintf(str, "Previous string is 射 d units long", 
size, cx); 

X = size.cx ； // 전 문자렬의 마감위 치로 이동한다 . 

TextOut (memdc, X, Y, str, strlen(str)) ； 

Y = Y + tm.tmHeight + tm. tmExternalLeading ； // 개 행 한다 . 
X = 0 ； // X 자리표를 재설정한다 . 

sprintf (str, "Screen dimensions ： %d %d M , maxX, maxY) ； 
TextOut (memdc, X, Y, str, strlen(str)) : 

Y = Y + tm. tmHeight + tm. tmExternalLeading ； // 개 행 한다 . 
InvalidateRect (hwnd, NULL, 1); 

break ； 

case IDM_RESET ： 


X = Y = 0； 
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// 배경을 색칠하여 지운다 . 

PatBlt (memdc, 0, 0, maxX, maxY, PATCOPY) ； 

InvalidateRect (hwnd, NULL, 1); 
break ； 

case IDM_FONT ： 

if(lfontswitch) { // 새로운 서체로 반전절환한다 . 
holdf = (HFONT) SelectObject (memdc, hnewf) ； 
fontswitch = 1 ； 

} 

eke { // 본래의 서체로 반전절환한다 . 

SelectObject(memdc, holdf); 
fontswitch = 0 ； 

} 

break ； 

case IDM—EXIT: 

response = MessageBox(hwnd, "Quit the Program?’’, 
’’Exit”, MB—YESNO); 
if (response == ID YES) PostQuitMessage(O); 
break ； 

case IDM_HELP ： 

MessageBox (hwnd, 

” F2: Display\nF3: Change Font\nF4: Reset", 
” Font Fun", MB_OK) ； 

break ； 

} 

break ； 

case WM_PAINT ： // 다시그리 기요구를 처 리 한다 . 
hdc = BeginPaint (hwnd, &paintstruct) ； // 장치 상황을 얻 는다 . 

// 가상창문을 화면에 복사한다 . 

BitBltChdc, 0, 0, maxX, maxY, memdc, 0, 0, SRCCOPY) ； 
EndPaint(hwnd, &paintstruct) ； // 장치 상황을 해 제 한다 . 
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break ； 

case WM_DESTROY ： II 프로그람을 끝낸다 . 

DeleteDC (memdc) ； 

PostQuitMessage(O) ; 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 


return 0 ； 

} 

이 프로그람에서 사용되는 자원파일을 아래 에 보여 주었다. 


ttinclude 〈 windows. h> 
#include "text.h" 


FontMenu MENU 

{ 

POPUP M &Fonts" { 

MENUITEM ，，& Display \tF2”, IDM_SHOW 
MENUITEM "Change &Font\tF3", IDM.FONT 
MENUITEM ” &Reset\tF4”, IDM—RESET 
MENUITEM "E&xitXtCtrl+X' 1 , IDM_EXIT 

} 

MENUITEM M &Help M , IDM—HELP 

} 


FontMenu ACCELERATORS 

{ 

VK_F1, IDM.HELP, VIRTKEY 
VK_F2, IDM—SHOW, VIRTKEY 
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VK_F3, IDM_FONT, VIRTKEY 
VK_F4, IDM_RESET, VIRTKEY 
IDM 一 EXIT 

} 

머 리 부파일 TEXT . H 의 내 용을 아래 에 보여 주었 다. 

#define IDM_SHOW 100 
#define IDM.FONT 101 
Mefine IDM—RESET 102 
#define IDM_EXIT 103 
#define IDM.HELP 104 

이 프로그람의 실행결과를 다음의 그림 8-2 에 보여 주었 다. 


Fonts H 심 P 


The font is 16 pixels high. 

This is on the next line. Previous string is 156 units long 
Screen dimensions ： 800 600 

The font is 13 pixels high. 

This is on the next line. Previous string is 111 units long 
Screen dimensions: 800 GOO 

The font is 16 pixels high. 

This is on the next line. Previous string is 156 units long 
Screen dimensions ： 800 600 


The font is 13 pixels high. 
This is on the next line. Pre 
jScreen dimensions: 800 61 


그림 8-2. 내장서제프로그람의 실행결과 

이 프로그람의 동작은 다음과 같다. [ Display ] 차림표를 선택 하면 현재 선택 되여 있 
는 서체로서 본문이 출력된다. [Change Font ] 차림표를 선택하면 ANSI 가변간격서체와 
체 계 설정서체 가 서 로 바뀌 면서 선택된다. [ Reset ] 차림 표를 선택 하면 창문의 표시내 용을 
소거할수 있 다. 이 경 우에 는 X 자리 표와 Y 자리 표가 령 으로 재 설정 되 고 PATCOPY 를 
지정 한 PatBlt( ) 를 호출하여 가상창문의 배경 이 색 칠된다. 


다시 한보 전진 


Unicode 

영어나 도이월란드어 등 서유럽나라들의 언어에서 사용되는 자모들은 
ANSI 문자모임을 사용하여 표시할수 있 다. ANSI 문자모임 은 8 bit 문자를 사용하 
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므로 256 종류이 상의 문자를 표시 할수 없 다. (ANSI 문자모임 은 7 bit 의 ASCII 코 
드의 확장모임이다.) 

이것은 조선어나 중어처럼 256 종류이상의 문자를 필요로 하는 일부 아시아 
나라들의 언어 에서 문제로 된다. 이 러한 언어 에도 대응하기 위해 Unicode 라는 
문자모임이 작성되 였다. Unicode 에서는 한 문자를 16 bit 로 표시하므로 매우 큰 
문자모임 을 실현 할수 있 다 . (16536 문자까지 ) 호환성 을 유지 하기 위 해 Unicode 
의 선두 256문자는 ANSI 문자모임에서 정의된 문자들과 일치하도록 되여 있다. 

Windows 2000 은 프로그람의 국제 대 응판을 쉽 게 작성 할수 있도록 
Unicode 를 전면적으로 지원하고 있다. Unicode 와 코드변환을 진행하는 기능 
을 가진 Win 32 API 함수들이 많이 제공되고 있다. 실례로 ToUnicode ( ) 는 가 
상건코드를 Unicode 로 변환하는 API 이 다. Windows 2000 은 프로그람의 번역 
시의 설정에 따라 Unicode 또는 ASCII 코드의 어느 하나로 자동적으로 넘기기 
되는 범용적 인 자료형도 제공하고 있다. 


전용서체의 작성 


전용서제를 작성 하는것을 상당히 복잡한것으로 생각할수도 있으나 실제 로는 아주 간 
단하다. 전용서체를 사용하면 두가지 우점 이 있다. 첫번째 우점은 응용프로그람에 고유 
한 외 적 특징 을 주는것 이 다. 다음으로 자체의 서체 (전용서체 )를 작성 하여 본문의 출력 을 
정확히 조종할수 있다는것이다. 

전용서체를 작성할 때는 서제형을 정의할 필요가 없다. 그대 신에 기존의 서체형 에 
변경을 가하여 목적하는 도안으로 하면 된다. 그러므로 작성하는 서체의 매개 문자들의 
도안을 정의할 펼요는 없다. 

전용서 체 를 작성 하려 면 CreateFont ( ) 라는 API 함수를 사용한다. 아래 에 선언을 보 
여 주었다. 

HFONT CreateFont(int Height , int Width , int Escapement , 
int Orientation , int Weight , 

DWORD Ital , DWORD Underline , 

DWORD StrikeThru , DWORD Charset , 

DWORD Precision , DWORD ClipPrecision , 
DWORD Quality , DWORD PitchFam , 

LPCSTR TypefaceName ) : 
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서 체 의 높이 를 Height 에 설정 한다. Height 가 령인 경 우에 는 체 계 설정 의 높이 가 사 
용된다. 서체의 너비를 Wid 仕 i 에 설정한다. Wid 仕 I 가 령 인 경우에는 현재의 확대축소비 
에 따라 Windows 가 적 당한 값을 설정 해 준다. Height 와 Width 는 다 론리 단위 로 설 
정 한다. 

창문에 대 하여 본문을 임의의 각도로 표시할수도 있다. 이 각도는 Escapement 에 
설정한다. 일반적인 수평방향의 본문에서는 이 값을 령으로 한다. 본문의 각도를 설정하 
는 경우에는 시계바늘회전방향의 반대로 0.1 ᄋ 를 단위로 하여 값을 지정한다. 실례로 값 
을 900으로 설 정하면 본문이 90° 회 전하므로 수직 방향으로 출력 되 게 된 다. 

문자의 경사도도 Orientation 을 리용하여 설정할수 있다. 여기에서도 수평선에 대 
해 시계바늘회전방향의 반대로 0.1° 를 단위로 값을 설정 한다. 

§ tJ 2 : 체계설정으로는 CreateFont ( ) 의 파라메터 인 Escapement 와 Orientation 에 같 
은 값을 설정하여야 한다. 그러나 도형방식으로 GM_ADVANCED 를 설정한 경우에는 
이 두 파라메터에 서로 다른 값을 설정 할수 있다. 도형방식을 설정하는 방법은 계 9 장에 
서 설명한다. 


Weight 에는 0〜100 의 범위 에서 서체의 무게를 임의 로 설정한다. 이 값을 령 으로 
하면 체계설정의 굵기가 설정된다. 표준의 굵기값은 400 이며 굵은체는 700 이다. 서체의 
굵기 를 설정 하기 위해 아래 에 보여 주는 마크로들중 어 느 하나를 사용할수도 있 다. 

FW_DONTCARE 

FW_THIN 

FW_EXTRALIGHT 

FW—LIGHT 

FW_NORMAL 

FW_MEDIUM 

FW_SEMIBOLD 

FW_BOLD 

FW_EXTRABOLD 

FW_HEAVY 

경 사체 를 작성하는 경 우에 는 Ital 에 0 이 아닌 값을 설정 한다. 경 사체 가 아닌 경 우에 
는 이 파라메터 에 령을 설정 한다. 밑선이 있는 서체를 작성하는 경우에는 Underline 에 
령 아닌 값을 설정 한다. 밑선이 없는 경우에는 이 파라메터 를 령 으로 설정 한다. 취소선 
이 있는 서체를 작성하는 경우에는 StrikeThru 에 0 아닌 값을 설정한다. 취소선이 없 
는 경 우에 는 이 파라메터 에 령 을 설정 한다. 
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Charset 에는 문자모임을 설정 한다. 뒤 에서 작성 하는 실례 프로그람에서는 여기 에 
ANSI-CHARSET 를 설 정 하고 있 다. Precision 에 는 출력 의 정 밀도를 설정 한다. 이 파라 
메터는 출력을 요구되는 서체의 실지 형태 에 어느 정도 맞추겠는가를 결정한다. 실례프 
로그람에서는 OUT_DEFAULT_PRECIS 를 설정하고 있다. 

ClipPrecision 에는 자르기 ( Clipping ) 의 정밀도를 설정 한다. 이것은 문자가 자르기 
령 역 을 빠져 나왔을 때 어 떻 게 자르기 를 진행 하는가를 결정 하는것 이 다. 실 례 프로그람에 서 
는 CLIP_DEFAULT_PRECIS 를 설정 하고 있 다. ( Charset , Precision 및 ClipPrecision 에 
설정할수 있는 다른 값들에 대 해서는 API 참고서 를 참조하면 된다.) 

Quality 는 실제의 출력장치를 위해 제공되는 물리서체에 론리서체를 어느 정도 맞 
추겠는가를 결정하는것 이 다. 일 반적 으로 사용되 는 값을 아래 에 보여 주었 다. 


DEFAULT-QUALITY DRAFT-QUALITY PROOF_QUALITY 


PitchFam 에는 서체의 간격과 계렬을 설정한다. 간격으로는 다음의 어느 한 마크로 
를 선택할수 있 다. 

DEFAULT_PITCH FIXED_PITCH VARIABLE_PITCH 

유효한 서체의 계 렬은 다음의 여섯개 이다. 


FF_DECORATIVE FF_DONTCARE 

FF—ROMAN FF—SCRIPT 


FF_MODERN 

FF—SWISS 


서 체 계 렬 이 무엇 이 든 상관 없는 경 우에 는 FF—DONTCARE 계，%: 설 정 한다. 서 체 
의 계렬은 지정한 서체형이 체계에 존재하지 않는 경우에만 의미가 있다. PitchFam 의 
값을 설정하려 면 간격의 값과 계 렬의 값을 하나씩 OR 연산으로 결합한다. 

서체형 이름의 지시자를 TypefaceName 에 설정한다. 이 이름은 32 문자이 하여 야 한 
다. 이 서체형이름의 서체가 체계에 설치되여 있어야 한다. 그러나 이 파라메터에 
NULL 을 설정하면 다른 파라메 터 에서 설정한 외형과 호환성 있는 서체를 Windows 
2000 이 자동적 으로 선택 하여 준다. (이 장의 뒤부분에서 사용가능한 서체를 렬거 하는 방 
법 을 설 명한다. ) 

호출이 성공하면 CreateFont( ) 는 서 체의 손잡이를 돌려 준다. 실패 한 경 우에 는 
NULL 을 돌려 준다. CreateFont( ) 를 사용하여 작성된 서체는 프로그람을 완료하기전에 
삭제 하여 야 한다. 서체 를 삭제 하려면 DeleteObject( ) 를 호출한다. 

두 종류의 전용서체 실례프로그람을 실례 8-3 에 보여 주었다. 첫번째 서체는 
Courier New 에 기 초한것 이 며 두번째 서 체 는 Century GotMc 에 기 초한것 이 다. 
[Change Font ] 차림 표를 선택하면 새 로운 서체 가 선택된다. 이 프로그람은 앞 절에서 


교육성 프로그람교육멘터 


249 



Windows 2000 프로그람작성 법 


작성한 프로그람과 같은 자원파일 및 같은 머리부파일을 리용한다. 프로그람의 실행결과 
를 그림 8-3 에 보여 주었 다. 

실례 8-3. CustomFont 프로그람 
// 전용서체의 작성 


^include < windows. h> 

Itinclude <cstring> 
ttinclude <cstdio> 

^include "text.h" 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
char szWinName [] = ” My Win”; // 창문들 라스의 이름 

char str[255] ； // 출력 할 문자렬 을 보관한다 . 
char fname[40] = "Default”; // 서체의 이름 

int X=0, Y=0 ； // 현재의 출력위 치 

int maxX, maxY; // 화면의 크기 

HDC memdc ； // 가상장치의 손잡이를 보관한다 . 

HBITMAP hbit ； // 가상비트매프를 보관한다 . 

HBRUSH hbrush ； // 붓의 손잡이를 보관한다 . 

HFONT holdf, hnewfl, hnewf2 ； // 서체의 손잡이를 보관한다 . 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 

// 창문믈라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ； 


wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl.IpszClassName = szWinName ； // 창문콜라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
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wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) : // 큰 아이콘 
wcl. hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 

wcl. IpszMenuName = "FontMenu" : // 기본차림 표 

wcl.cbClsExtra = 0 ； // 보조기 억기령역은 필요 없다 . 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 

// 창문클라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 

/* 창문콜라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Using Custom Fonts", // 계목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Wtadows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 너비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 

NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

3; 

// 건반가속기를 적재 한다 . 

hAccel = LoadAccelerators(hThisInst, "FontMenu") : 

// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성한다 . 

while(GetMessage (&msg, NULL, 0, 0)) 
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{ 

if ( ! Translate Accelerator (hwnd, h Accel, &msg)) { 
TranslateMessage(&msg) ； // 건반통보를 변환한다 . 
DispatchMessage(&msg) ； // Windows 2000 에 조종을 넘 긴다 . 

} 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 

PAINTSTRUCT paintstruct ； 
static TEXTMETRIC tm ； 

SIZE size; 

static fontswitch = 0 ； 
int response ； 

switch (message) { 
case WM.CREATE ： 

// 화면의 크기를 엄는다 . 

maxX = GetSystemMetrics(SM_CXSCREEN) ； 

maxY = GetSystemMetrics(SM_CYSCREEN) ； 

// 가상창문을 작성한다 . 

hdc = GetDC(hwnd) ； 

memdc = CreateCompa 切 bleDC(hdc); 

hbit = CreateCompatibleBitmap (hdc, maxX, maxY) ； 

SelectObject (memdc, hbit) ； 

hbrush = (HBRUSH) GetStockObject(WHITE_BRUSH) ； 
SelectObject (memdc, hbrush) ； 

PatBlt (memdc, 0, 0, maxX, maxY, PATCOPY) ； 

// 새로운 서체를 작성한다 . 

hnewfl = CreateFont(14, 0, 0, 0, FW.NORMAL, 
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0, 0, 0, ANSI.CHARSET, 
OUT_DEFAULT_PRECIS, 
CLIP_DEFAULT_PRECIS, 
DEFAULT.QUALITY, 

DEFAULT_PITCH | FF.DONTCARE, 
"Courier New”) ； 

hnewf2 = CreateFont(20, 0, 0, 0, FW 一 SEMIBOLD, 

0, 0, 0, ANSI.CHARSET, 
OUT_DEFAULT_PRECIS, 
CLIP_DEFAULT_PRECIS, 
DEFAULT.QUALITY, 

DEFAULT-PITCH | FF_DONTCARE, 
"Century Gothic") ； 

ReleaseDC (hwnd, hdc) ； 
break ； 

case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM_SHOW ： 

// 본문색을 검은색으로 , 배경방식을 TRANSPARENT 로 한다 . 

SetTextColor (memdc, RGB(0, 0, 0)) ； 

SetBkMode(memdc, TRANSPARENT) ； 


// 본문치수를 얻는다 . 


GetTextMetrics (memdc, &tm) ； 


sprintf(str, "%s font is 射 d pixels high.”, 

: fname, tm. tmHeight); 

TextOut (memdc, X ， Y, stir, strlen(str)) ； 

Y = Y + tm. tmHeight + tm. tmExternalLeading ； // 개 행 한다 . 

strcpy(str, "This is on the next line. ”) ; 

TextOut (memdc, X, Y, str, strlen(str)) ； 

// 문자렬의 길이를 구한다 . 

GetTextExtentPoint32 (memdc, str, strlen(str), &size) ； 
sprintf(str, "Previous string is %ld units long”, 
size.cx) ； 

X = size.cx ； // 앞 문자렬의 마감위치로 이동한다 . 

TextOut (memdc, X, Y, str, strlen(str)) ； 

Y = Y + tm.tmHeight + tm.tmExternalLeading ； // 개 행 한다 . 
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X = 0; // X 자리표률 재설정한다 . 

sprintf(str, ” Screen dimensions: %d %d M , maxX, maxY); 
TextOut (memdc, X, Y, str, strlen(str)) ； 

Y = Y + tm. tmHeight + tm. tmExternalLeading ； // 개 행 한다 . 

InvalidateRect (hwnd, NULL, 1); 
break ； 

case IDM_RESET: 

X = Y = 0 ； 

// 배경을 색칠하여 소거한다 . 

PatBlt (memdc, 0, 0, maxX, maxY, PATCOPY); 

InvalidateRect (hwnd, NULL, 1); 

break ； 

case IDM_FONT ： 
switch (fontswitch) { 
case 0 ： // 새로운 서체 1 로 반전절환한다 . 
holdf = (HFONT) SelectObject(memdc, hnewf 1) ； 
f ontswitch = 1 ； 

strcpy(fname, ” Courier New"); 
break ； 

case 1 ： // 새로운 서체 2 로 반전절환한다 . 

SelectObject (memdc, hnewf2) ； 
fontswitch = 2 ； 

strcpy(fname, "Century Gothic") ； 
break ； 

default ： // 본래의 서체로 반전절환한다 . 

SelectObject (memdc, holdf) ； 
fontswitch = 0 ； 
strcpy(fname, ’’Default”); 

} 

break ； 

case IDM.EXIT ： 

response = MessageBox(hwnd, "Quit the Program?”, 

” Exit，，, MB_YESNO) ； 
if (response == ID YES) PostQuitMessage(O); 
break ； 

case IDM_HELP: 
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MessageBox (hwnd, 

”F2: Display\nF3: Change Font\nF4 ： Reset", 
"Custom Fonts", MB_OK) ； 

break ； 

} 

break ； 

case WM.PAINT: // 다시 그리 기요구를 처 리한다 . 
hdc = BeginPaint(hwnd, &paintstruct) ； // 장치 상황을 얻 는다 . 

// 가상창문을 화면에 복사한다 . 

BitBlt(hdc, 0, 0, maxX, maxY, memdc, 0, 0, SRCCOPY) ； 

EndPaint(hwnd, &paintstruct) ； // 장치 상황을 해 제 한다 . 
break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

DeleteDC (memdc); 

DeleteObject (hnewf 1); 

DeleteObject (hnewf2) ； 

PostQuitMessage (0); 
break ； 
default : 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리 률 맡긴 다 . */ 
return DefWindowProc(hwnd, message, wParam, lParam); 


return 0 ； 


: Help 

Default font is 16 pixels high. 

This is on the next line. Previous string is 156 units long 
Screen dimensions： 800 600 

Century Gothic font is 20 pixels high. 

This is on the next line. Previous string is 190 units long 
Screen dimensions: 800 600 

Default font is 16 pixels high. 

This is on the next line. Previous string is 156 units long 
Screen dimensions： 800 600 


그림 8-3. 전용서제프로그람의 실행결과 
교육성 프로그람교육쎈터 


255 







Windows 2000 프로그람작성 법 


CreateFontlndirecU ) 으 1 사용방법 


CreateFont ( ) 를 대신하여 여 러가지 경우에 편리 하게 쓰이는 CreateFontIndirect () 
라는 API 함수가 있다. 이 함수는 幻": T 구조체 에 설정된 정보에 토대하여 전용서 

체 를 작성한다. 아래 에 선언을 보여 주었다. 

HFONT CreateFontlndirect (CONST LOGFONT * lpFont ) ; 

이 함수는 lpFont 에서 가리키는 LOGFONT 구조체로 지정된 정보에 가장 가까운 
서체를 작성하고 그의 손잡이를 돌려 준다. 함수의 호출이 실패한 경우는 NULL 을 돌 
려 준다. 프로그람을 실행하기전에 DeleteObjectC ) 를 사용하여 서체의 손잡이를 삭제 
하여 야 한다. 

LOGFONT 구조체는 서체와 관련한 론리정보를 보관한다. 다음에 구조체의 정의를 
보여 주었다. 


typedef struct tagLOGFONT 


LONG If Height ； 

LONG If Width ； 

LONG If Escapement ； 
LONG If Orientation ； 
LONG If Weight ； 

BYTE If Italic ； 

BYTE lfUnderline ； 

BYTE If Strikeout ； 

BYTE IfCharSet ； 

BYTE lfOutPrecision ； 
BYTE lfClipPrecision ； 
BYTE If Quality ； 

BYTE lfPitchAndFamily ； 


// 서체의 높이 
// 서체의 너비 
// 본문의 각도 
// 문자의 경사 
// 굵기 

// 경사체라면 령 아닌 값 
// 밑선이 있으면 령 아닌 값 
// 취소선이 있으면 령 아닌 값 
// 문자모임 
// 출력의 정밀도 
// 자르기의 정밀도 
// 출력의 질 
// 간격과 서체계렬 


CHAR lfFaceName[LF_FACESIZE] : // 이 름 


} LOGFONT ； 


LOGFONT 구조체의 성 원은 앞에서 설명 한 CreateFontC ) 의 파라메터와 의미와 사 
용방법 이 동일하다. 실례 로 앞의 프로그람에서 CreateFontC )를 사용하여 작성 한 
Century Go 仕 lie 서체와 같은것을 CreateFontIndirect ( ) 를 사용하여 작성 하는 프로그람 
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코드를 아래에 보여 주었다. 


LOGFONT If ； 


lf.lfHeight = 20 ； 
lf.lfWidth = 0 ； 

If. If Escapement = 0 ； 

If. If Orientation = 0 ； 
lf.lfWeight = FW_SEMIBOLD ； 
lf.lfltalic = 0 ； 

If. If Underline = 0 ； 
lf.lfStrikeOut = 0 ； 

If. If CharSet = ANSI.CHARSET ； 
lf.lfOutPrecision = OUT.DEF AULT.PRECIS ； 
lf.lfClipPrecision = CLIP.DEF AULT_PRECIS ； 
lf.lfQuality = DEF AULT.QUALIT Y ； 

lf.lfPitchAndFamily = DEFAULT.PITCH | FF.DONTCARE ； 
strcopy(If.IfFaceName, “Century Gothic”); 
hnewf2 = CreateFontIndirect(&lf) ； 


이 경 우에 는 CreateFontC )를 대 신하여 CreateFontlndirect ( )를 사용해 야 할 필요 
는 없지만 반드시 CreatFontIndirect () 를 사용해 야 하는 경우도 존재 한다. 실례로 기존 
의 서체정보를 얻을 때는 서체의 속성이 LOGFONT 구조체에 보관된다. 이 구조체의 정 
보를 사용하여 CreateFontlndirect ( )로 서체를 작성할수 있다. 


본문의 회전 


Windows 2000 이 제 공하는 서 체 조종기 능중 가장 우수한 기 능의 하나로서 본문을 X 
축의 주위로 회전시키거나 문자의 경사도를 간단히 변경시키는 기능이 있다. 이것은 화 
면상에 수평 이 아닌 방향으로도 본문을 표시할수 있다는것 이 다. 

본문출력의 각도를 바꾸러 면 CreateFontC )를 사용하여 서체 를 작성 할 때 
Escapement 와 Orientation 에 목적 하는 각도를 설 정한다. 이 각도는 수평 축으로부터 
1/10 도단위 로 시 계 바늘회 전방향의 반대 방향으로 하여 설정 한다. Escapement 는 본문의 
기초선의 각도를 결정하고 Orientation 은 문자의 경사도를 결정한다. 

본문을 회전시키려고 한다면 이 두개의 값들을 같게 하여야 한다. 이렇게 하면 회전 
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된 기초선을 따라 문자렬이 놓이게 된다. 

실례 8-4 의 프로그람은 앞의 프로그람에서 작성된 Courier 와 Gothic 서체를 변경하 
여 그것들이 45° 경사로 표시되도록 한다. Courier 서체의 본문은 Escapement 와 
Orientation 에 정의값을 주므로 오른쪽 웃방향으로 표시된다. Gothic 서체의 본문은 
Escapement 와 Orientation 에 부의 값을 주고 있으므로 오른쪽 아래 방향으로 표시된다. 
프로그람의 실행결과를 그림 8-4 에 보여 주었다. 


실례 8-4. RotateFont 프로그람 
// 본문의 회전 

ttinclude 〈 windows. h> 
ttinclude <cstring> 

^include <cstdio> 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
char szWinName[] = ” My Win"; // 창문들라스의 이름 
char str[255]; // 출력 할 문자렬을 보관한다 . 

HFONT hnewfl, hnewf2 ； // 서체의 손잡이를 보관한다 . 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 


// 창문클라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ； 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문콜라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0 ； // 체계설정의 형식 
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wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ; // 큰 아이론 
wcl. hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl.lpszMenuName = NULL ； // 콜라스차림표는 없다 . 
wcl.cbClsExtra = 0 ； // 보조기억기령역은 필요 없다 . 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject (WHITE_BRUSH) ; 

// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Rotating Text", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결 정 하게 한다 . 
CW_USEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

3; 


// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) : 

UpdateWindow (hwnd) : 

// 통보문순환고리를 작성 한다 . 

while(GetMessage (&msg, NULL, 0, 0)) 

TranslateMessage(&msg) : // 건반통보를 변환한다 . 
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DispatchMessage(&msg) ； II Windows 2000 에 조종을 넘 긴다 . 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 

PAINTSTRUCT ps ； 


switch (message) { 
case WM_CREATE ： 

// 이 서체의 각도는 45° 오른쪽웃방향이다 . 

hnewfl = CreateFont(14, 0, 450, 450, FW 一 NORMAL, 

0, 0, 0, ANSI.CHARSET, 
OUT_DEFAULT_PRECIS, 
CLIP_DEFAULT_PRECIS, 
DEFAULT.QUALITY, 
DEFAULT_PITCH | FF.DONTCARE, 
"Courier New”) ； 

// 이 서체의 각도는 45° 오른쪽웃방향이다 . 
hnewf2 = CreateFont(20, 0, -450, -450, FW—SEMIBOLD, 
0, 0, 0, ANSI.CHARSET, 
OUT_DEFAULT_PRECIS, 
CLIP_DEFAULT_PRECIS, 
DEFAULT.QUALITY, 
DEFAULT_PITCH | FF.DONTCARE, 
"Century Gothic”); 

break ； 

case WM_PAINT ： // 다시 그러 기 요구를 처 러 한다 . 
hdc = BeginPaint (hwnd, &ps) ； // 장치 상황을 얻 는다 . 


SelectObject (hdc, hnewfl) ； 
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strcpy(str, "This string is angled 45 degrees up. ; 
TextOutChdc, 0, 200, str, strlen(str)) ； 


SelectObject (hdc, hnewf2) ； 

strcpy(str, "This string is angled 45 degrees down.") ； 
TextOut (hdc, 10, 0, str, strlen(str)) ； 

EndPaint(hwnd, &ps) ； // 장치 상황을 해 제 한다 . 
break ； 

case WM.DESTROY ： // 장치상황을 해제하고 프로그람을 끝낸다 . 
DeleteObject (hnewf 1) ; 

DeleteOb ject (hnewf 2) ； 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 

} 

return 0 ； 

} 
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서체의 렬거 


지금까지의 프로그람에서 서체를 작성할 때는 목적하는 서체를 사용할수 있다는것을 
가정 하고 있 었 다. 그러 나 Windows 프로그람을 작성 하면서 어 떤 상황을 가정 하는것 은 
좋지 않은 일이다. 례하면 체계에 서체가 추가될수도 있고 체계로부터 서체가 삭제될수 
도 있다. 

사용가능한 서체를 렬거 하려면 En ^ FontFamiliesEx ( ) 타는 API 함수를 사용한다. 
아래에 선언을 보여 주었다. 


int EnumFontFamiliesEx (HDC hdc , LPLOGFONT lpFontlnfo , 

FONTENUMPROC EnumFunc , 
LPARAM IParam , DWORD NotUsed ) : 


hdc 는 서체를 엄는 장치상황의 손잡이 이다. 장치상황이 다르면 지원되는 서체도 다 
르다. 서체의 종류를 정의하는 다양한 속성은 lpFontInfo ( ) 에서 지정되는 LOGFONT 
구조체 에 보관된다. (LOGFONT 구조체 에 대 해서는 이 장을 시 작하면서 설명 하였 다.) 

EnumFunc 는 서 체 가 하나 렬거 될 때 마다 호출되 는 역 호출함수에 대 한 지 시 자이 다. 
lParam 은 EnumFunc 에서 지정되는 역호출함수에 응용프로그람으로부터 어떤 정보를 
보내 는데 사용된 다. NotUsed 는 사용되 지 않으므로 령 을 설 정하여 야 한다. 이 함수는 
EnumFunc 가 맨 마지 막에 호출되 였을 때 의 돌림 값을 돌려 준다. 

EnumFontFamiliesEx ( ) 을 호출하기전에 lpFontlnfo 에서 지정되는 LOGFONT 구 
조체 의 세 개 성 원 lfCharSet , lfPitchAndFamily 및 IfFaceName 을 초기 화하여 야 한다. 

특정한 문자모임의 서체만을 렬거하는 경우에는 lfCharSet 에 문자모임의 이름을 설 
정 한다. 모든 문자모임의 서체 를 렬거 하는 경우에는 DEFAULT_CHARSET 를 설정 한다. 
특정한 서체형의 서체만을 렬거하는 경우에는 IfFaceName 에 서체형의 이름을 설정한다. 
모든 서체 형의 서체를 렬거 하는 경우에는 이 성원에 령 문자 렬을 설정 한다. 
lfPitchAndFamily 에 는 령 을 설정 하여 야 한다. 

Windows 2000 이 서체를 렬거할 때마다 EnumFunc 에서 지정된 함수가 호출된다. 
이 함수는 렬거된 서체를 처리하며 계속하여 다른 서체를 요구한다면 령 아닌 값을 돌려 
주며 요구하지 않는다면 령을 돌려 준다. 이 함수의 정의는 다음과 갈다. 


int CALLBACK EnumFunc (ENUMLOGFONTEX * lpLFInfo , 
NEWTEXTMETRICEX * lpTMinfo , 
int type , LPARAM lParam ); 


lpLFInfo 는 렬거된 서체에 대한 론리정보를 보관하는 ENUMLOGFONTEX 구조체 
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의 지시 자이 다. lpTMinfo 는 서 체의 물리정 보를 보관하는 NEWTEXTMETRICEX 구조 
체 의 지 시 자이다. 

TrueType 가 아닌 서체의 경우에는 NEWTEXTMETRICEX 구조체 대신에 
TEXTMETRIC 구조체 의 지 시자가 전해 진 다. type 는 서 체 의 종류를 가리 키 는것이 므로 
다음의 어느 한 값으로 된다. 

RASTER—FONTTYPE TRUETYPE—FONTTYPE 

DEVICE-FONTTYPE 

lParam 에는 Ex ( ) 의 lParam 에 설정된 값이 보관된다. 

이식과 관련한 요점 : Windows 3.1 은 EnumFontFamiliesEx ( ) 를 지 원 하지 않는 다. 
Windows 3.1 프로그람에서는 EnumFont ( ) 또는 EnumFontFamilies ( ) 를 사용한다. 
Windows 와 )00 에로 이식하는 경우에는 이것들을 EnumFontFamiliesEx ( )로 치환해야 한다. 

ENUMLOGFONTEX 구조爲와 정의를 아래에 보여 주었다. 


typedef struct tagENUMLOGFONTEX 
{ 

LOGFONT elfLogFont ； 

BYTE elfFullName[LF_FULLFACESIZE] : 

BYTE elf Style [LF_FACESIZE] : 

BYTE elf Script [LF_FACESIZE] : 

} ENUMLOGFONTEX; 

elfLogFont 는 론리서 체의 거의 모든 정보를 가지 고 있는 LOGFONT 구조체 이 다. 
이 구조체 가 가지 는 정 보는 CreateFontC ) 혹은 CreateFontlndirect ( ) 를 호출할 때 사 
용된다. 서체의 완전한 이름은 elfFullName 에 보관된다. 형식 (굵은체，경사체 등)은 
elf Style 에 보관된다. 이 성원은 TrueType 서체가 아닌 경우에는 의미가 없다. 대본 
( Script ) 의 이 름은 elfScript 에 보관된 다. 

서체렬거프로그람 

실례 8-5 의 프로그람코드는 두가지 방법 으로 서체 를 렬거하는 방법 을 보여 주었다. 
먼저 [ Enumerate ] 차림표에서 [Available Font ] 항목을 선택하면 지원되는 모든 서체형 
의 서체 가 렬거된 다. [Selected Typeface ] 를 선택 하면 지정된 서 체 형 의 서체 만이 렬거 
된다. 프로그람의 실행결과를 그림 8-5 에 보여 주었다. 


// 서체의 완전이름 
// 서체의 형식 
// 서체에서 사용되는 대본 
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실 례 8-5. Font 프로그람 
// 서체의 렬거 


itinclude 〈 windows. h> 
ttinclude <cstring> 

^include <cstdio> 
itinclude "font, h" 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM); 
int CALLBACK FontFunc (ENUMLOGFONTEX *lpLF, 

NEWTEXTMETRICEX *lpTM, 
int type, LPARAM IParam); 

BOOL CALLBACK FontDialog (HWND hdwnd, UINT message, 

WPARAM wParam, LPARAM IParam) ； 

char szWinName[] = ” My Win"; // 창문들라스의 이름 

char str [255] ； // 출력 할 문자렬 을 보관한다 . 

char fontstr[255] ； // 사용자가 입력한 서체 이름을 보관한다 . 

int X=0, Y=0 ； // 현재의 출력위 치 

int maxX, maxY; // 화면의 크기 

int linespacing ； // 행간격 

HDC memdc ； // 가상장치의 손잡이를 보관한다 . 

HBITMAP hbit ； // 가상비트매프의 손잡이를 보관한다 . 

HBRUSH hbrush ； // 붓의 손잡이를 보관한다 . 

HINSTANCE hlnst ； 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 
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WNDCLASSEX wcl ； 

HACCEL hAccel ； 

// 창문물라스를 정의 한다 . 

wcl. cbSize = sizeof (WNDCLASSEX) : 


wcl.Mnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문콜라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이 콘 

wcl. hlconSm = NULL ； // 큰 아이론의 축소판을 사용한다 . 

wcl. hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl. IpszMenuName = "FontEnumMenu" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject (WHITE_BRUSH) ; 

// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Enumerating Fonts", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Wtadows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 너비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 
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hThisInst, II 실체의 손잡이 
NULL // 추가파라메터 는 없 다 . 

); 


hlnst = hThisInst ； // 현재 실체의 손잡이를 보관한다 . 

// 건반가속기를 적재한다 . 

hAccel = LoadAccelerators (hThisInst, "FontEnumMenu") ； 


// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) ； 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

if (! Translate Accelerator (hwnd, hAccel, 技 msg)) { 
TranslateMessage(&msg) ； // 건반통보를 변환한다 . 
DispatchMessage(&msg) ； // Windows 2000 에 조종을 넘 긴다 . 

} 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 

static TEXTMETRIC tm ； 

PAINTSTRUCT ps ； 

LOGFONT If ； 
int result ； 
int response ； 
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switch (message) { 
case WM.CREATE ： 

// 화면의 크기를 엄는다 . 

maxX = GetSystemMetrics(SM_CXSCREEN) ； 

maxY = GetSystemMetrics(SM_CYSCREEN) ； 

// 가상창문을 작성한다 . 

hdc = GetDC(hwnd) ； 

memdc = CreateCompatibleDC(hdc) ； 

hbit = CreateCompatibleBitmap (hdc, maxX, maxY) ； 

SelectObject (memdc, hbit) ； 

hbrush = (HBRUSH) GetStockObject(WHITE_BRUSH) ； 
SelectObject (memdc, hbrush) ； 

PatBlt (memdc, 0, 0, maxX, maxY, PATCOPY) ； 

// 본문치수를 얻는다 . 

GetTextMetrics (memdc, &tm) ； 

// 행 간격을 구한다 . 

linespacing = tm. tmHeight + tm. tmExternalLeading ； 


// 굴색으로 표식을 표시한다 . 

SetTextColor (memdc, RGB (255, 100, 0)); 

TextOut(memdc, X, 0, "Typeface", strlenC'Typeface")) I 
TextOut(memdc, X+200, 0, ” Style”, strlen(”Style")); 

TextOut (memdc, X+300, 0, ” Script”, strlen ("Script")); 
SetTextColor(memdc, RGB(0, 0, 0)); 

ReleaseDC (hwnd, hdc) ； 
break ； 

case WM_COMMAND: 

switch (LOWORD (wParam)) { 
case IDM.FONTS ： // 서체를 표시한다 . 

Y = linespacing + linespacing/2 ； 

PatBlt (memdc, 0, linespacing, maxX, maxY, PATCOPY) ； 

lf.lfCharSet = DEF AULT_CH ARSET : 
strcpy (If. IfFaceName, ; 

If. lfPitchAndFamily = 0 ； 
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// 서체를 렬거한다 . 
hdc = GetDC(hwnd) ; 

EnumFontFamiliesEx (hdc, &lf ， 

(FONTENUMPROC) FontFunc, (LPARAM)hwnd, 0) ； 
ReleaseDC (hwnd, hdc) ； 

break ； 

case IDM_TYPEFACE ： // 선택된 서체형을 표시한다 . 

// 서체의 이름을 얻는다 . 

result = DialogBox (hlnst, ” FontDB”, hwnd, 

(DLGPROC) FontDialog); 


if(!result) break ； // 사용자가 취소하였다 . 

Y = linespacing + linespacing/2 ； 

PatBlt (memdc, 0, linespacing, maxX, maxY, PATCOPY) ； 

If. If CharSet = DEF AULT_CH ARSET ； 
strcpy (If. IfFaceName, fontstr) ； 
lf.lfPitchAndFamily = 0 ； 

// 지정된 서체의 모든 형식을 렬거한다 . 
hdc = GetDC(hwnd) ; 

EnumF ontF amiliesEx (hdc, &lf ， 

(FONTENUMPROC) FontFunc, (LPARAM) hwnd, 0 )； 
ReleaseDC (hwnd, hdc) ； 

break ； 

case IDM_EXIT: 

response = MessageBox(hwnd, "Quit the Program?”, 

” Exit”, MB.YESNO) ； 
if (response == ID YES) PostQuitMessage(O) ； 
break ； 

case IDM_HELP: 

MessageBox (hwnd, 

” F2: Show Fonts \nF3 ： Show Typeface \ n M 
” F3: Exit”, "Show Fonts", MB_OK) ; 
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break ； 

} 

break ； 

case WM.PAINT: // 다시 그리 기요구를 처 리한다 . 
hdc = BeginPaint(hwnd, &ps); // 장치 상황을 얻 는다 . 

// 가상창문을 화면에 복사한다 . 

BitBlt(hdc, 0, 0, maxX, maxY, memdc, 0, 0, SRCCOPY) ； 

EndPaint(hwnd, &ps) ； // 장치 상황을 해 제 한다 . 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

DeleteDC (memdc); 

PostQuitMessage (0); 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam); 


return 0 ； 

} 

// 서체를 렬거하는 역호출함수 

int CALLBACK FontFunc (ENUMLOGFONTEX *lpLF, 
NEWTEXTMETRICEX *lpTM, 
int type, LPARAM IParam) 

{ 

int response; 

RECT rect ； 

// 서체의 정보를 표시한다 . 

TextOut (memdc, X, Y, lpLF->elfLogFont. IfFaceName, 

strlen(lpLF->elfLogFont.IfFaceName)) ； // 서체의 이름 


if (type == TRUETYPE-FONTTYPE) 

TextOut (memdc, X+200, Y, (char *) lpLF->elf Style, 
strlen((char *) lpLF->elfStyle)) ； // 형식 
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else 

TextOut(memdc, X+200, Y, "N/A”, 3 )； 

TextOut(memdc, X+300, Y, (char *) lpLF->elfScript, 

strlen((char *)lpLF->elfScript)) ； // 대본의 종류 

Y += linespacing ； 

InvalidateRect ((HWND) IParam, NULL, 0 )； 

// 의뢰자구역의 현재 크기를 엄는다 . 

GetClientRect ((HWND) IParam, &rect) ； 

// 창문의 하단에서 정지한다 . 

if( (Y + linespacing) >= rect. bottom) { 

Y = linespacing + linespacing/2 ； // 창문의 상단으로 돌아간다 . 
response = MessageBox((HWND)IParam, "More?", 

"More Fonts?”, MB_YESNO) ； 
if (response == IDNO) return 0 ； 

PatBlt(memdc, 0, linespacing, maxX, maxY, PATCOPY) ； 

} 


return 1 ； 


// 서체를 렬거하는 대화칸 

BOOL CALLBACK FontDialog (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 


case IDCANCEL ： 
EndDialog (hdwnd, 0); 
return 1 ； 


case IDD.ENUM ： 

// 서체형의 이름을 얻는다 . 

GetDlgltemText (hdwnd, IDD_EB1, fontstr, 80); 
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EndDialog (hdwnd, 1) ； 
return 1 ； 

} 

break ； 

} 

return 0 ； 

} 

이 프로그람은 아래의 자원파일을 리용한다. 

#include 〈 windows. h> 

♦include "font, h" 


FontEnumMenu MENU 

{ 

POPUP "Enumerate” { 

MENUITEM "Available &Fonts\tF2", IDM_FONTS 
MENUITEM "Selected &Typeface\tF3", IDM_TYPEFACE 
MENUITEM "E&xit\tCtrl+X", IDM_EXIT 

} 

MENUITEM "&Help", IDM_HELP 


FontEnumMenu ACCELERATORS 

{ 

VK_F1, IDM_HELP, VIRTKEY 
VK_F2, IDM_FONTS, VIRTKEY 
VK_F3, IDM_TYPEFACE, VIRTKEY 
"~X", IDM_EXIT 

} 

FontDB DIALOGEX 10, 10, 100, 60 
CAPTION "Enumerate Typeface" 

STYLE WS_POPUP | WS_CAPTION | WS_SYSMENU 

{ 

CTEXT "Enter Typeface", 300, 10, 10, 80, 12 
EDITTEXT IDD_EB1, 10, 20, 80, 12, ES_LEFT | 
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WS.BORDER | ES.AUTOHSCROLL | WS.TABSTOP 
DEFPUSHBUTTON "Enumerate" IDD.ENUM, 30, 40, 40, 14 

} 

머 리 부파일 FONT. H 의 내 용을 아래 에 보여 주었 다. 


#define IDM.FONTS 100 

#define IDM.TYPEFACE 101 

ttdefine IDM.EXIT 102 

#define IDM.HELP 103 

ttdefine IDD_EB1 200 

#define IDD_ENUM 201 


i -ini jj 

Enumerate Help 

[Typeface Style Script 


System 
Fixedsys 
Terminal 
MS Serif 
MS Sans Serif 
Courier 


Symbol 
Small Fonts 
Photoshop Large 
Photoshop Small 
ADMUI3Lg 
ADMUI3Sm 
Marlett 



N/A Western 

N/A Western 

N/A Western 

Regular Symbol 


그림 8-5. 서제렬거프로그람의 실행 a 과 

프로그람의 내 용을 자세 히 살펴 보자. [Available] 차림 표가 선택 되 면 lf.lfFace 
Name 에 NULL 을 설정 하여 EnumFontFamiliesEx( ) 가 호출된다. 이 에 의해 체계 가 지 
원하는 모든 서체형의 서체가 렬거된다. 

[Selected Typeface] 차림 표가 선택되면 작은 대 화칸이 표시되 고 거 기 에서 특정 한 
서체형의 이름을 입 력 할수 있다. 입 력된 이름은 If.IfFaceName 성 원에 보관된다. 이렇 
게 되여 지정된 서체형의 서체만이 렬거된다. 프로그람의 처리를 간단히 하기 위해 이 
함수는 창문을 다 채우게 정보를 표시하면 렬거를 계속하겠는가를 질문하는 통보칸을 표 
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시한다. 렬거를 계속하려는 경우에는 창문에 계속표시가 진행된다. 창문의 현재의 크기 
를 판정 하기 위 해 FontFunc ( ) 는 GetClientRectC 고를 호출하고 있 다. GetClientRect () 
함수의 선언은 다음과 같다. 


BOOL GetClientRect (HWND hwnd , LPRECT lpDim ) : 


hwnd 는 크기 를 구하려 는 창문의 손잡이 이 며 lpDim 은 창문의 의 뢰 자구역 의 현재 의 
크기 가 보관되 는 RECT 구조체 의 지 시 자이 다. (RECT 구조체 는 제 3 장에 서 설 명 하였 다. ) 
함수의 호출이 성공하면 령 아닌 값이 돌려 지며 실패하면 령이 돌려 진다. 이 함수는 
창문의 의 뢰 자구역 의 크기 를 알려 고 할 때 가장 편 리하게 사용된 다. 

이 프로그람에서는 창문의 현재의 높이에 본문의 다음 행을 표시하는데 충분한 령역 
이 있는가 어떤가를 판정하기 위해 rect . bottom 의 값을 사용하고 있다. 

서체가 렬거될 때마다 LOGFONT 구조체에 서체의 정보가 보관된다. 이 구조체를 
CreateFontlndirect ( ) 에 리용하여 렬거된 매 서체를 작성하고 그 서체로 문자렬을 표 
시해 볼수 있다. 이렇게 하면 목적하는 서체의 형태를 눈으로 보면서 실제로 확인할수 
있 다. 

Windows 2000 이 지원하는 서체와 본문의 조종기능은 매우 풍부하다. 필요한 기능 
들에 대하여서는 프로그람작성자들 자신이 보다 자세히 조사해 보아야 할것이다. 다음 
장에서는 도형을 주제로 하여 창문의 출력에 대한 설명을 계속한다. 
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도형의 사용법 


Windows 2000 은 창문에 도형 을 그리 기 위 한 API 함수들을 수많이 제 
공하고 있다. Windows 는 도형 방식의 조작체 계이 므로 이것은 놀라운 일 이 
아니 다. 도형은 Windows 환경의 모든 부분에 통합되 여 있으므로 간단하 
게 취급할수 있다. 

Windows 2000 이 지 원 하는 모든 도형 함수에 대 해 설 명 하는것 은 불가 
능하므로 이 장에서는 그중에서 가장 기초적인 점，직선，4 각형 및 타원 
등을 그리 는 함수만을 설 명한다. 이 장에 서 는 도형을 창문에 출력하는 방 
식 을 변경 하는 방법 에 대 해 서 도 설명 한다. Windows 2000 의 도형 기 능은 
매우 강력하므로 보다 심도 있게 알려 면 직접 시험해 보아야 한다. 

도형함수의 리 용방법 을 보여 주는 실례 로서 간단한 그림그리 기프로그 
탐을 작성 한다. Windows 2000 의 강력 한 도형 그리 기 기능에 의거 하면 그리 
길지 않은 프로그람코드로도 그림그리 기프로그람을 작성할수 있 다는것 을 
알게 될것이다. 
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도형의 자리표계 


도형의 자리표계는 본문에 기 초한 함수에서 사용하던것과 같다. 체 계 설정 으로는 창 
문의 왼쪽웃모서 리 의 자리 표가 원점 인 (0， 0) 으로 되 며 론리단위 는 화소 (pixel) 이 다. 그 
러 나 자리표계 및 론러단위로부터 화소에로 넘기는 방법은 임의로 변경 할수 있다. 

Windows 2000 및 Windows 전반은 현/功字/乂八 Current position) 를 관리한다. 현재 
위 치는 일부 도형함수들에서 참조되거 나 변경된다. 프로그람의 기동시에 는 현재위 치가 
(0， 0) 으로 설정된다. 현재위치를 눈으로 볼수는 없으며 도형의 유표와 같은것은 표시되 
지 않는다. 현재위치는 도형함수가 다음에 그리기를 개시하는 창문상에서의 위치를 가리 
킨 다. 


펜과 붓 


Windows 의 도형체계는 편/과 붓이라는 두개의 객체에 기초하고 있다. 4 각형이나 
타원과 같은 닫긴 도형은 체계설정으로 현재 선택되여 있는 붓으로 채색된다. 펜은 직선 
이 나 곡선을 그리 기 위한 객 체 로서 여 러 가지 도형함수에서 사용된다. 체 계 설정의 펜은 
검은색이며 한 화소의 너비로 되여 있으나 이 러한 속성들을 변경시킬수 있다. 

지금까지의 실례프로그람들에서는 내장된 객체만을 사용하여 왔다. 실례로 창문의 
의뢰자구역을 색칠하는데 사용된 흰색의 내장붓을 들수 있다. 이 장에서는 전용붓이나 
펜을 작성 하는 방법 에 대해서도 설명 한다. 


점의 그리기 


■SetP 公 e /신이 라는 API 함수를 사용하면 임의의 색 으로 점을 그릴수 있다. 선언은 다 
음과 갈다. 

COLORREF SetPixelCHDC hdc, int X, int Y, COLORREF color); 

hdc 는 그리기 대 상으로 되는 장치상황의 손잡이 이 다. 점의 자리 표를 X, Y 에 설정 하 
고 점의 색을 color 에 설정 한다 . ( COLORREF 자료형 은 제 8 장에서 설명 하였다.) 이 
함수는 호출직전의 점의 색을 돌려 주며 오유가 발생하거나 지정한 위치가 창문밖에 놓 
이는 경우에는 -1 을 돌려 준다. 
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직선의 그리기 


직 선을 그리 자면 LineTo () 항수를 사용해 야 한다. 이 함수는 현재 선택 된 
펜으로 직선을 그린다. 선언은 다음과 같다. 

BOOL LineTo(HDC hdc , int X , int Y ) ； 

hdc 에는 장치상황의 손잡이를 설정 한다. 직선은 현재위 치를 시 작점 으로 하고 X , Y 
로 지정된 자리표를 끝점으로 하여 그려진다. 그리기가 끝난후 현재위치는 ( X , Y ) 로 변 
경된다. 이 함수는 호출이 성공하면 즉 직선이 그려 지면 령이 아닌 값을 돌려 주며 실 
패 하면 령을 돌려 준다. 

LineToC ) 가 직선의 시작점으로 현재위치를 사용하고 그리기가 끝나면 현재위치를 
직선의 끝점으로 변화시키는것은 흔히 직선을 그릴 때 방금 전에 그린 직선의 끝점에서 
다음 직선의 그러기를 시작하는 경우가 많이 있기때문이다. 이려한 때 LineToC )를 효 
과적으로 사용하여 시작점의 자리표를 다시 설정하는 번거로움을 배제할수 있다. 이것을 
바라지 않는 다면 LineToC )를 호출하기 전에 다음에 설명하는 Afovero&O 함수를 사 
용하여 임의의 위치에 현재위치를 설정할수 있다. 

현재위치의 설정 


임의의 위치에 현재위치를 설정하려면 Afovero & O 함수를 사용해 야 한다. 선언은 
다음과 같다. 

BOOL MoveToExCHDC hdc , int X , int Y , LPPOINT lpCoord ) : 

장치상황의 손잡이를 hdc 에 설정하고 새로운 현재위치의 자리표를 X , 모 에 설정한 
다. 직선의 현재위 치 가 lpCoord 로 지적된 P 幻/ ZVr 구조체 에 돌려 전다. POINT 구조체의 
정의는 다음과 갈다. 


typedef struct tagPOINT { 

LONG x； 

LONG y； 

} POINT； 

그러나 lpCoord 파라메 터에 NULL 을 설정한 경우에 MoveToEx ( ) 는 현재위 치를 
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돌려 주지 않는다. 

MoveToEx ( ) 함수는 호출이 성공하면 령 이 아닌 값을 돌려 주고 실패하면 령을 돌 
려 준다. 


원호의 그리기 


ArcO 훈/수를 사용하면 현재펜의 색으로 원호(타원의 일부)를 그릴수 있다. 선언은 
다음과 갈다. 

BOOL Arc(HDC hdc , int upX , int upY , int lowX , int lowY , 


int startX , int startY , int endX , int endY ) : 


hdc 는 원호를 그릴 대상으로 되는 장치상황의 손잡이 이다. 원호는 두개의 객체 에 
의해 정의된다. 원호는 4각형으로 둘러싸인 타원의 일부이다. 

이 4 각형 의 왼쪽웃모서 리는 upX , upY 로 지정 되 고 오른쪽아래모서 리는 lowX , 
lowY 로 지정된다. 실제로 그려 지는 타원의 일부분 즉 원호는 4각형의 중심과 startX , 
startY 로 지정되는 점을 련결하는 직선과의 사귐점에서부터 시작하여 4 각형의 중심과 
endX , endY 로 지정된 점을 련결하는 직선과의 사귐점에서 끝난다. 

체계설정으로는 원호가 startX , startY 로부터 시계바늘반대방향으로 그려 진다. 이 
그리 기 방향을 SetArcDirectionC ) 이 타는 API 함수를 사용하여 변경 시 킬수도 있 다. 그림 
9-1 에 Arc ( ) 의 동작을 보여 주었다. 

Arc ( ) 는 호출이 성공하면 령 이 아닌 값을 돌려 주며 실패하면 령을 돌려 준다. 


원호의 그리기 



'01 타원의 일부를 
원호로 한다. 



lowX , lowY 


바깥달이하는 4 각형 


그림 9-1. Arc ( ) 함수의 동작 
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4각형의 그리기 


Rectangle () 할수를 사용하면 현재펜의 색으로 4각형을 그릴수 있다. 선언은 다음과 
갈다. 

BOOL Rectangle (HDC hdc , int upX , int upY , int lowX , int lowY ); 

hdc 는 장치상황의 손잡이 이다. 4각형의 왼쪽웃모서리의 자리표를 upX , 배포 에 설 
정 하고 오른쪽웃모서 리의 자리 표를 lowX , lowY 에 설정 한다. 이 함수는 호출이 성공하 
면령이 아닌 값을 돌려 주고 오유가 발생하면 령을 돌려 준다. 4 각형의 내부는 현재의 
붓으로 색칠된다. 

RoundRect () 함수를 사용하면 모서 리 가 원활한 4 각형 을 그릴수 있 다. 모서 리 가 원 
활한 4 각형 이 란 모서 리 부분만이 원형 인 4 각형 이 다. RoundRect ( ) 함수의 선언은 다음과 
같다. 

BOOL RoundRect (HDC hdc , int upX , int upY , int lowX , int lowY , 
int curveX , int curveY ) : 

첫 다섯 개 의 파라메 터 는 Rectangle ( ) 과 같다. 모서 리 를 원활하게 하는 곡선은 
curveX , curveY 의 값으로 결정된다. 이 파라메 터들은 곡선으로 되는 타원의 너 비와 
높이를 지정하기 위한것들이다. RoundRect ( ) 는 호출이 성공하면 령이 아닌 값을 돌려 
주고 실패 하면 령을 돌려 준다. 모서 리 가 원활한 4 각형의 내부는 현재 붓으로 자동적으 
로 채색된다. 


타원과 부재형의 그리기 


현재 선택되여 있는 펜의 색으로 타원이나 원을 그리자면 Ellipse () 항수를 사용하여 
야 한다. 선언은 다음과 같다. 

BOOL Ellipse (HDC hdc , int upX , int upY , int lowX , int lowY ); 

hdc 는 타원을 그리려는 장치상황이다. 타원은 바깥닿이하는 4각형을 지정하여 정의 
된 다 . 4 각형 의 왼쪽웃모서 리 를 upX , 배구 에 설정 하고 오른쪽아래 모서 리 를 lowX , lowY 
에 설정 한다. 원을 그리 는 경 우에 는 바른 4각형 을 지 정한다. 
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이 함수는 호출이 성 공하면 령 이 아닌 값을 돌려 주며 실패하면 령 을 돌려 준다. 타 
원의 내부는 현재의 붓을 사용하여 색칠된다. 

타원과 관련된 도형으로 부채형이 있다. 부채형은 원호 및 원호의 량단과 타원의 중 
심을 련결하는 직선으로 구성되는 객체이다. 부채형을 그리자면 /" feO 함수를 사용해야 
한다. 선언은 다음과 갈다. 

BOOL Pie (HDC hdc , int upX , int upY , int lowX , int lowY , 
int startX , int startY , int endX , int endY ); 

hdc 는 부채형이 그려 지는 장치상황의 손잡이이다. 원호부분은 두개의 객체에 의해 
정의된다. 원호는 4 각형으로 둘러싸인 타원의 일부분이다. 이 4 각형의 왼쪽웃모서리는 
upX , upY 로 지정되 고 오른쪽아래모서 리의 자리표는 lowX , lowY 로 지정된다. 

실제로 그려 지는 타원의 일부 즉 원호는 4 각형의 중심과 startX , startY 로 지정되 
는 점을 련결하는 직선과의 사귐점으로부터 시작하여 4 각형의 중심과 endX , endY 로 
지정된 점을 련결하는 직선과의 사귐점에서 끝난다. 체계설정으로는 원호가 시계바늘회 
전방향의 반대방향으로 그러진다. 

부채형은 현재의 펜의 색으로 그려 지며 현재의 붓을 사용하여 채색된다. Pie () 함수 
는 호출이 성공하면 령 이 아닌 값을 돌려 주며 오유가 발생하면 령을 돌려 준다. 


펜의 조종 


도형객체는 현재 선택된 콘/을 사용하여 그릴수 있다. 체계설정의 펜은 검은색이며 
너비는 1 화소 ( Pixel ) 로 되여 있다. 내장펜에는 검은색, 흰색 및 빈 펜의 세 종류가 있 
다. 내 장펜의 손잡이 를 얻 자면 이 미 설명한 GetStockObjectC )를 사용한다. 내 장펜을 
가리 키는 마크로는 BLACK _ PEN , WHITE_PEN 및 NULL_PEN 이 다. 펜손잡이 의 자료 
형 은 HPEN 이 다. 

내장펜만으로는 실현할수 있는것이 제한되여 있으므로 응용프로그람에서 자체의 펜 
이 필요하게 된 다. CreatePen () 을 사용하면 자체의 펜을 작성 할수 있 다. 선언은 다음과 
갈다. 

HPEN CreatePen(int style , int width , COLORREF color ); 

style 파라메터는 작성할 펜의 형 식을 결정 하는 파라메터 이 다. 이것은 다음의 어느 
한 값으로 된다. 
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PS—DASH 

파선 

PS—DASHDOT 

한점 파선 

PS DASHDOTDOT 

두점 파선 

PS—DOT 

점선 

PSJNSIDEFRAME 

둘러 막힌 령역의 내부에 속하는 실선 

PS NULL 

빈 펜 

PS_SOLID 

실선 


점선이나 파선은 너비가 1 인 펜으로만 지정 할수 있다. PS_imiDEFRAME 聲은 펜 
의 너비가 1보다 큰 경우에도 그린 내용이 객체안에 들어간다. 

실례로 형식이 PSJNSIDEFRAME 이고 너비가 1 보다 큰 펜을 사용하여 4 각형을 
그리면 외형을 그리는 직선이 4 각형령역을 벗어 나지 않게 된다. 그러나 
PSJNSIDEFRAME 이 아닌 형식으로 너비가 넓은 펜을 사용하면 직선이 부분적으로 객 
체 즉 4각형의 령 역을 벗어 나게 된다. 

펜의 너 비는 론리단위 로 width 에 설정한다. 펜의 색 은 COLORREF 의 값으로 
color 에 설정 한다. CreatePen ( ) 은 호출이 성공하면 펜의 손잡이를 돌려 주며 실패 하면 
NULL 을 돌려 준다. 

펜이 작성되면 SelectObjectC )를 사용하여 펜을 장치상황에 선택한다. 실례로 아래 
의 프로그람코드는 붉은펜을 작성하고 그것을 장치상황에 선택한다. 

HPEN hRedPen ； 

HRedPen = CreatePen(PS_SOLID, 1, RGB(255,0,0)) ； 

SelectObject(dc, hRedpen); 


작성된 전용펜은 프로그람이 완료하기전에 DeleteObject ( )를 사용하여 삭제하여야 
한다. 


전용붓의 작성 


내 장펜의 경우와 같이 Windows 2000 이 제공하는 내 장붓은 그것을 사용하여 실현할 
수 있는것이 제한되여 있으므로 개성적인 붓，다시말하여 전용붓을 작성하여 리용하는 
경우가 많다. 전용붓은 전용펜과 류사한 방법으로 작성된다. 여러가지 형식의 전용붓을 
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작성 할수 있 다. 가장 일 반적 인 전용붓은 균일붓 (solid brush ) 이 다. 균일붓은 
CreateSolidBrush( ) 타는 API 함수를 사용하여 작성된다. 선언은 다음과 같다. 


HBRUSH CreateSolidBrush (COLORREF color ) : 


붓의 색을 color 에 설정하고 함수를 호출하면 붓의 손잡이가 돌려 진다. 호출이 실 
패하면 NULL 이 돌려 진 다. 

전용붓이 작성되면 그것을 SelectObjectC )를 사용하여 장치상황에 선택한다. 실례 
로 아래의 프로그람코드는 록색의 붓을 작성하고 그것을 장치상황에 선택한다. 

HBRUSH hGreenbrush ； 

hGreenbrush = CreateSolidBrush (RGB (0, 255, 0)); 

SelectObject(dc, hGreenbrush); 

작성할수 있는 전용붓의 형식 에는 균일붓외 에도 두가지 종류가 더 있다. 그것은 무 
느/붓 (Pattern brush ) 과 줄무스/붓 (Hatch brush ) 이다. 무늬붓은 비트매프의 무늬로 령역 
을 색 칠하는 붓이다. 줄무늬붓은 몇 가지 줄무늬모양을 사용한다. 이 붓들은 
CreatePattem Brush ( ) 및 CreateHatchBrush ( )를 사용하여 작성 된다. 선언은 다음과 
갈다. 


HBRUSH CreatePatternBrush (HBITMAP hBMap ) : 

HBRUSH CreateHatchBrush (int Style , COLORREF color ) : 


CreatePatternBrush ( M 시는 붓의 무늬로 사용되는 비트매프의 손잡이를 hBMap 에 
설정한다. 이 비트매프가 령역 이나 배경의 색칠에 사용된다. 이 함수는 붓의 손잡이를 
돌려 주며 오유가 발생한 경우에는 NULL 을 돌려 준다. 


참고 : 장치독립비트매프를 사용하여 붓을 하는 경우에는 CreateDIBPatternBrushPt( ) 
를 사용한다. 


CreateHatchBrush ( )를 사용하여 작성된 붓은 줄무늬 모양으로 된다. Style 에 설정 
되는 줄무늬모양의 형식으로는 다음의 어느 한 값을 설정한다. 


圖^^^^^^^^^^^^^^^ 
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HS CROSS 

격 자모 양 

HS DIAGCROSS 

경사진 격자모양 

HS FDIAGONAL 

오른쪽 우로 향한 경사선 

HS HORIZONTAL 

수평 

HS—VERTICAL 

수직 


붓의 색은 COLORREF 의 값으로 color 에 설정된다. 이 함수는 붓의 손잡이를 돌 
려 주며 호출이 실패 한 경 우에 는 NULL 을 돌려 준다. 

전용펜과 전용붓의 삭제 


필요 없게 된 전용펜과 전용붓은 삭제 하여 야 한다. 이 것은 DeleteObjectC ) 라는 
API 함수를 사용하여 진행된다. 내장객체는 삭제할수 없다. (엄밀히 말하면 삭제해서는 
안된다.) 객체 가 어떤 장치상황에 선택된 상태 에서는 삭제할수 없다. 


출력방식의 설정 


프로그람에서 창문에 도형을 출력할 때는 그때 설정되여 있는 출력방식에 의해 출력 
을 창문에 복사하는 방법이 결정된다. 체계설정으로는 출력이 창문에 그대로 복사되여 
현재의 내용을 덧쓰기하지만 다른 출력방식을 사용할수도 있다. 

실례로 출력과 창문의 현재 내용을 AND 연산, OR 연산 및 XOR 연산할수도 있다. 
출력방식을 설정 하기 위 해서 는 SetROP 2( ) 합숙•를 사용한다. 선언은 다음과 같다. 


int SetROP 2 (HDC hdc , int Mode ); 


hdc 에 는 대 상으로 되 는 장치 상황의 손잡이 를 설정 하고 Mode 에 는 새 로운 출력 방식 
을 설정한다. SetROP 2( ) 은 이 함수를 호출하기 전의 출력방식을 돌려 주며 호출이 실 
패하면 령을 돌려 준다. Mode 에는 표 9-1 에 준 값들가운데서 어느 한 값을 설정한다. 


표 9-1. 출력방식의 설정 값 
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쓰기 한다. 

R 2 —MASKPEN 

출력 이 현재 화면의 내 용과 AND 연산된다. 

R 2 —MASKNOTPEN 

출력을 반전한것과 현재화면의 내용이 AND 연산 
된 다. 

R 2 _MASKPENNOT 

출력 이 현재 화면의 내 용을 반전한것과 AND 연산 
된 다. 

R 2 MERGEPEN 

출력이 현재화면의 내용과 OR 연산된다. 

R 2 _MERGENOTPEN 

출력을 반전한것과 현재화면의 내용이 OR 연산 
된다. 

R 2 —MERGEPENNOT 

출력이 현재화면의 내용을 반전한것과 OR 연산 
된다. 

R 2 NOP 

출력이 변경된다. 

R 2 —NOT 

출력 이 현재화면의 내용을 반전시킨것으로 된다. 

R 2 NOTCOPYPEN 

출력을 반전시킨것이 창문에 복사된다. 

R 2 NOTMASKPEN 

출력 이 R 2 MASKPEN 을 반전한것 으로 된 다. 

R 2 —NOTMERGEPEN 

출력 이 R 2 MERGEPEN 을 반전한것 으로 된 다. 

R 2 NOTXORPEN 

출력 이 R 2 XORPEN 을 반전한것 으로 된 다. 

R 2 —WHITE 

출력 이 흰색으로 된다. 

R 2 —XORPEN 

출력 이 현재 화면의 내 용과 XOR 연산된다. 


R 2 —XORPEN 은 화면상의 원래의 정 보를 잃지 않고 일시 적 인 출력을 진행 하는 경 우 
에 편리하게 사용된다. 이 것은 XOR 연산이 가지는 특수한 기능에 의해 실현된다. 

실례 로 A 라는 값과 B 라는 값을 XOR 연산하고 다시 한번 묘 로 XOR 연산하면 본래 
의 A 로 돌아간다. 출력 과 화면을 XOR 연산하고 다시 한번 동일 한 출력 으로 XOR 연산 
하면 화면의 내용은 원래 상태로 복귀된다. 

익것은 화면에 어떤것 을 일시적으로 표시할 때 XOR 연산하여 출력하면 간단히 다시 
한번 XOR 연산하여 화면을 본래 의 내 용으로 돌려 보낼수 있 다는것 을 의 미한다. 

이 기술은 제 7 장에서 비트매프의 출력과 관련한 설명을 할 때도 간단히 설명되였다. 
다음에 작성하는 도형 의 실 례 프로그람에 서 도 이 기 술을 리 용한다. 

겸 하여 알아둘것은 ROP 는 Raster Operation 의 략어 라는것 이 다. 이 기능은 화면표 
시 장치 같은 주사선 장치 에 만 제 공된 다 . 


도형의 실례 


실례 9-1 의 프로그람은 지 금까지 설명한 여 러 가지 도형 함수들의 실례 를 보여 주는 
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것 이 다. 이 프로그람은 기 능이 제 한된 간단한 그림 그리 기 ( paint ) 프로그람이 다. 이 프로 
그람에서는 WM_PAINT 통보문을 받아 들일 때 7 장에서 설명 한 가상창문기술을 리 용하 
여 창문을 다시그리 기한다. 


실례 9-1. Graph 프로그람 
// 간단한 그림그리기프로그람 


ttinclude 〈 windows. h> 

^include "graph, h” 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 

char szWinName[] = ” My Win"; // 창문들라스의 이름 

int maxX , maxY ； // 화면의 크기 

HDC memdc ； // 기억기장치상황의 손잡이 
HBITMAP hbit ； // 호환성 있는 비트매프의 손잡이 
HBRUSH hCurrentbrush, hOldbrush ； // 붓의 손잡이 
HBRUSH hRedbrush, hGreenbrush, hBluebrush, hNullbrush ； 

// 펜의 작성 

HPEN hOldpen ； // 펜의 손잡이 

HPEN hCurrentpen ； // 현재 선택되여 있는 펜 

HPEN hRedpen, hGreenpen, hBluepen, hBlackpen ； 

int X=0, Y=0; 
int pendown = 0 ； 
int endpoints = 0; 

int StartX=0, StartY=0, EndX=0, EndY=0; 
int Mode ； 


int WINAPI WinMain (HINSTANCE hThisInst, HINSTANCE hPrevInst, 


LPSTR IpszArgs, int nWinMode) 
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MSG msg ； 

WNDCLASSEX wcl ； 
HACCEL hAccel ； 


// 창문콜라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ; 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. li 犯 zClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계 설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이론 
wcl. hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl. IpszMenuName = "GraphMenu" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 


// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


A 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow( 
szWinName, // 창문믈라스의 이름 
"A Simple Paint Program", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자리 표는 Windows 가 결 정 하게 한다 . 
CWJJSEDEFAULT, // Y 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 높이 는 Windows 가 결 정 하게 한다 . 
NULL, // 어미창문은 없다 . 
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NULL, 

hThisInst, 

NULL 


// 차림표는 없다 . 

// 실체의 손잡이 
// 추가파라메터 는 없 다 . 


// 건반가속기 를 적 재한다 . 

hAccel = LoadAccelerators (hThisInst, ” GraphMenu”) ; 

// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd) ； 

// 통보문순환고리률 작성 한다 . 

while(GetMessage (&msg, NULL, 0, 0)) 

{ 

if(! TranslateAccelerator (hwnd, hAccel, &msg)) { 
TranslateMessage(&msg) ； // 건반통보를 변환한다 . 
DispatchMessage(&msg) ； // Windows 2000 에 조종을 넘 긴다 . 


return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 


WPARAM wParam, LPARAM IParam) 


{ 

HDC hdc ； 

PAINTSTRUCT paintstruct ； 
int response ； 

switch (message) { 
case WM.CREATE ： 

// 화면의 크기를 얻는다 . 

maxX = GetSystemMetrics(SM_CXSCREEN) ； 
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maxY = GetSystemMetrics(SM_CYSCREEN) ； 

// 가상창문을 작성한다 . 

hdc = GetDC(hwnd) ； 

memdc = CreateCompatibleDC(hdc) ; 

hbit = CreateCompatibleBitmap(hdc, maxX, maxY) ； 

SelectObject(memdc, hbit); 

hCurrentbrush = (HBRUSH) GetStockObject(WHITE_BRUSH); 
SelectObject (memdc, hCurrentbrush) ； 

PatBlt (memdc, 0, 0, maxX, maxY, PATCOPY) ； 

// 펜을 작성한다 . 

hRedpen = CreatePen(PS_SOLID, 1, RGB(255,0,0)) ； 
hGreenpen = CreatePen(PS_SOLID, 1, RGB (0,255,0)) ； 
hBluepen = CreatePen(PS_SOLID, 1, RGB (0,0,255)); 

// 붓을 작성 한다 . 

hRedbrush = CreateSolidBrush(RGB (255,0,0)) ； 
hGreenbrush = CreateSolidBrush (RGB (0,255,0)) ； 
hBluebrush = CreateSolidBrush (RGB (0,0,255)) ； 
hNullbrush = (HBRUSH) GetStockObject(HOLLOW_BRUSH) ； 


// 체계설정의 펜을 보관한다 . 

hBlackpen = hOldpen = (HPEN) SelectObject (memdc, hRedpen); 
hCurrentpen = hOldpen; 

SelectObject (memdc, hOldpen) ； 


ReleaseDC(hwnd, hdc); 
break ； 

case WM.RBUTTONDOWN : // 령역의 정의를 개시한다 . 
endpoints = 1 ； 

X = StartX = LOWORD(lParam) ； 

Y = StartY = HIWORD(lParam) ； 
break ； 

case WM.RBUTTONUP ： // 령역의 정의를 완료한다 . 
endpoints = 0 ； 

EndX = LOWORD(lParam) ； 

EndY = HIWORD(lParam) ； 
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break ； 

case WM.LBUTTONDOWN : // 그러기를 개시한다 . 
pendown = 1 ； 

X = LOWORD(lParam); 

Y = HIWORD(lParam); 
break ； 

case WM.LBUTTONUP ： // 그리기를 완료한다 . 
pendown = 0 ； 
break ； 

case WM.MOUSEMOVE ： 
if (pendown) { // 그리 기 한다 . 
hdc = GetDC(hwnd) ； 

SelectObject (memdc, hCurrentpen) ； 

SelectObject (hdc, hCurrentpen) ； 

MoveToEx(memdc, X, Y, NULL )； 

MoveToEx(hdc ， X, Y, NULL) ； 

X = LOWORD(lParam) ； 

Y = HIWORD(lParam) ； 

LineTo(memdc, X, Y); 

LineTo(hdc, X, Y); 

ReleaseDC (hwnd, hdc) ； 

} 

if (endpoints) { // 령 역을 둘러 싸는 선을 표시 한다 . 
hdc = GetDC(hwnd) ； 

// 점선을 그리는 펜을 선택한다 . 

hOldpen = (HPEN) SelectObject (hdc, hRedpen) ； 

// 출력방식을 XOR 로 변경한다 . 

Mode = SetROP2(hdc, R2.XORPEN) ； 

// 그러기를 하나 칠하지는 않는다 . 
hOldbrush = 

(HBRUSH) SelectObject (hdc, GetStockObject(HOLLOW_BRUSH)) ； 


// 낡은 점선 4각형을 소거한다. 

Rectangle (hdc, Star 松 :, StartY, X, Y )； 
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X = LOWORD(lParam) ； 

Y = HIWORD(lParam) ； 

// 새로운 점선 4 각형을 그린다. 

Rectangle (hdc, StartX, StartY, X, Y); 

// 체계설정의 붓으로 복귀한다. 
SelectObject (hdc, hOldbrush); 

SelectObject (hdc, hOldpen) ； 
SetROP2(hdc, Mode) ； 

ReleaseDC (hwnd, hdc) ； 

} 

break； 

case WM.COMMAND： 
switch (LOWORD (wParam)) { 
case IDM_LINE： 

// 현재의 펜을 선택한다. 

SelectObject (memdc, hCurrentpen); 


// 직선을 긋는다. 

MoveToEx (memdc, StartX, StartY, NULL); 
LineTo(memdc, EndX, EndY) ； 

InvalidateRect (hwnd, NULL, 1); 
break； 

case IDM_RECTANGLE： 

// 붓과 펜을 선택한다. 

SelectObject (memdc, hCurrentbrush) ； 
SelectObject (memdc, hCurrentpen); 


// 4 각형을 그린다. 

Rectangle (memdc, StartX, StartY, EndX, EndY) ； 

InvalidateRect (hwnd, NULL, 1); 
break； 

case IDM.ELLIPSE： 

// 붓과 펜을 선택한다. 
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SelectObject (memdc, hCurrentbrush) ； 


SelectObject (memdc, hCurrentpen) ； 


// 타원을 그린다. 

Ellipse (memdc, StartX, StartY, EndX, EndY) ； 

InvalidateRect (hwnd, NULL, 1); 
break； 

case IDM_RED: 
hCurrentpen = hRedpen； 
break； 

case IDM_BLUE: 
hCurrentpen = hBluepen； 
break; 

case IDM_GREEN： 
hCurrentpen = hGreenpen； 
break； 

case IDM_BLACK: 
hCurrentpen = hBlackpen； 
break； 

case IDM_REDFILL: 
hCurrentbrush = hRedbrush; 
break； 

case IDM_BLUEFILL: 
hCurrentbrush = hBluebrush； 
break； 

case IDM_GREENFILL： 
hCurrentbrush = hGreenbrush； 
break； 

case IDM_WHITEFILL： 
hCurrentbrush = hOldbrush； 
break； 

case IDM_NULLFILL: 
hCurrentbrush = hNullbrush； 
break； 

case IDM_RESET： 

// 현재위치률 (0, 0) 으로 재설정한다. 

MoveToEx(memdc, 0, 0, NULL) ； 
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// 배경을 칠하여 소거한다. 

SelectObject (memdc, hOldbrush) ； 

PatBlt(memdc, 0, 0, maxX, maxY, PATCOPY) ； 

InvalidateRect (hwnd, NULL, 1); 
break ； 

case IDM_EXIT ： 

response = MessageBox(hwnd, ” Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O) ； 
break ； 

case IDM_HELP ： 

MessageBox (hwnd, ”F2: Line\nF3 ： Rectangle \n” 

M F4 ： Ellipse\nF5 ： Reset", 

” Paint Hot Keys", MB_OK) ； 

break ； 

} 

break ； 

case WM.PAINT： // 다시 그러 기 요구를 처 러 한다. 
hdc = BeginPaint(hwnd, &paintstruct) ； // 장치 상황을 얻 는다. 

// 가상창문을 화면에 복사한다. 

BitBlt(hdc, 0, 0, maxX, maxY, memdc, 0, 0, SRCCOPY) ； 

EndPaint(hwnd, &paintstruct) ； // 장치 상황을 해제 한다. 
break； 

case WM.DESTROY ： // 프로 그람을 끝낸다. 
DeleteObject(hRedpen) ； // 펜을 삭제 한다. 

DeleteOb ject (hGreenpen) ; 

DeleteOb ject (hBluepen); 

DeleteOb ject (hBlackpen) ； 


DeleteOb ject (hRedbrush) ； // 붓을 삭제 한다. 
DeleteOb ject (hGreenbrush) ； 

DeleteOb ject (hBluebrush) ； 


DeleteDC (memdc) ； 
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DeleteObject(hbit) ； 

PostQuitMessage (0) ; 
break； 
default : 

/* 이 switch 문에서 지정된것 이외의 통보 문은 
Windows 2000 에 처 리 률 맡긴 다. */ 
return DefWindowProc(hwnd, message, wParam, lParam); 


return 0； 

} 

이 프로그람에 필요한 자원파일은 다음과 같다. 


ttinclude〈windows. h> 
^include "graph, h” 


GraphMenu MENU 

{ 

POPUP M &Shapes" 

{ 

MENUITEM ” &Line\F2 n , IDM_LINE 
MENUITEM ”&Rectangle\tF3”, IDM.RECTANGLE 
MENUITEM，，&Ellipse\tF4”, IDM.ELLIPSE 
MENUITEM ,, Eteit\tCtrl+X M , IDM.EXIT 

} 

POPUP，，&Options” 

{ 


POPUP "&Pen Color" 

{ 


MENUITEM ” &Red”, IDM_RED 
MENUITEM ，，技 Blue", IDM_BLUE 


MENUITEM "&Green", IDM.GREEN 
MENUITEM n Bl&ack M , IDM_BLACK 

} 

POPUP "&Fill Color" 
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MENUITEM 

MENUITEM 

MENUITEM 

MENUITEM 

MENUITEM 


n &Red”, IDM.REDFILL 
"&Blue", IDM_BLUEFILL 
"&Green", IDM.GREENFILL 
"&White”, IDM.WHITEFILL 
n &Null M , IDM_NULLFILL 


} 

MENUITEM ” &Reset\tF5”, IDM.RESET 


MENUITEM M &Help M , IDM.HELP 

} 


GraphMenu ACCELERATORS 

{ 

VK_F1, IDM_HELP, VIRTKEY 
VK_F2, IDM_LINE, VIRTKEY 
VK_F3, IDM.RECTANGLE, VIRTKEY 
VK_F4, IDM_ELLIPSE, VIRTKEY 
VK_F5, IDM.RESET, VIRTKEY 
'^X", IDM.EXIT 

} 

아래 의 머 리 부파일 GRAPH . H 도 필 요된 다. 


#define IDM.LINE 100 

Mefine IDM.RECTANGLE 101 

ttdefine IDM.ELLIPSE 102 

#define IDM.RED 103 

ttdefine IDM 一 GREEN 104 

ttdefine IDM_BLUE 105 

#define IDM.BLACK 106 

Mefine IDM.REDFILL 107 

ttdefine IDM.GREENFILL 108 

#define IDM_BLUEFILL 109 

ttdefine IDM.WHITEFILL 110 

Mefine IDM_NULLFILL 111 

#define IDM.RESET 112 

Mefine IDM.HELP 113 
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#define IDM_EXIT 114 

그러 기프로그람의 실 행 결과는 그림 9-2 와 같다. 



그리기프로그람은 다음과 같이 동작한다. 

마우스를 사용하여 자유로 직선이나 곡선을 그릴수 있다. 그림을 그리려면 왼쪽 단 
추를 누른채로 마우스를 끌기한다. 오른쪽 단추는 령역을 정의하는데 사용된다. 령역의 
시작점 에 마우스의 지시자를 이동하고 마우스의 오른쪽 단추를 누른채로 마우스의 지시 
자를 령역의 종점 으로 이동한다. 령 역 이 목적하는 크기 로 되 면 마우스의 오른쪽 단추를 
놓는다. 

령역을 설정하면 령역을 가리키는 4 각형이 표시된다. 그리고 정의된 령역의 내부에 
직선, 4각형 또는 타원을 그릴수 있다. 

이 도형들은 [ Shapes ] 차림표를 선택하여 그릴수 있다. [ Op 仕 ons ] 차림표를 사용하면 
새 로운 펜이 나 붓의 색을 설정 하거 나 창문의 내 용을 소거할수 있다. 그리 기프로그람코드 
의 내 용의 대부분은 쉽 게 리 해할수 있을것 이 다. 그러 나 몇 개의 중요한 부분이 있으므로 
그것들을 설명하자. 

그림그리기프로그람의 상세 

그림그리기프로그람을 기동하면 가상창문의 비트매프, 펜，붓과 같은 몇개의 객체들 
이 작성된다. 이 객체들은 프로그람이 완료될 때 삭제된다. 

변수 pendown 의 값은 마우스의 왼쪽 단추가 눌러워 져 있을 때 1로 설정된다. 그 
밖의 경우에는 령 으로 된다. 변수 endpoints 의 값은 마우스의 오른쪽 단추를 누르는것 
으로서 령역의 정의가 개시되였을 때 1 로 설정된다. 그밖의 경우에는 령으로 된다. 이 
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변수들은 WHMOt/SEMDF 표통보문을 어떻게 처 리하는가를 결정하는데 리용된다. 

프로그람에 서 가장 중요한 부분은 WM_MOUSEMOVE 통보문처 리 이 다. 내 용을 주의 
깊게 살펴 보자. 아래에 다시 한번 프로그람코드를 보여 주었다. 

case WM-MOUSEMOVE: 

if (pendown) { // 그리 기 한다. 
hdc = GetDC(hwnd) ; 

SelectObject (memdc, hCurrentpen) : 

SelectObject (hdc, hCurrentpen) : 

MoveToEx (memdc, X, Y, NULL) : 

MoveToEx(hdc, X, Y, NULL); 

X = LOWORD(lParam) : 

Y = HIWORD(lParam) : 

LineToCmemdc, X, Y); 

LineToChdc, X, Y) ； 

ReleaseDC(hwnd, hdc); 

if (endpoints) { // 령역을 둘러막는 선을 표시한다. 
hdc = GetDC(hwnd) ; 

// 점선을 그리는 펜을 선택한다. 

hOldpen = (HPEN) SelectObject (hdc , hRedpen) ; 

// 출력방식을 XOR 로 변경한다. 

Mode = SetROP2(hdc, R2_XORPEN) : 

// 그리 기는 하지만 칠하지는 않는다. 
hOldbrush = 

(HBRUSH) SelectObject (hdc, GetStockObject (HOLLOW_BRUSH)) ; 


// 낡은 점선 4 각형을 소거한다. 

Rectangle (hdc, StartX, StartY, X, Y )； 

X = LOWORD(lParam); 

Y = HIWORD(lParam) : 
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// 새 점선 4각형을 그린다. 

Rectangle (hdc, StartX, StartY, X, Y)； 

// 체계설정의 붓으로 복귀한다. 

SelectObject (hdc, hOldbrush) ; 

SelectObject (hdc, hOldpen) : 

SetROP2(hdc, Mode) : 

ReleaseDC (hwnd, hdc); 

} 

break； 

WM_MOUSEMOVE 통보문은 마우스가 움직 일 때마다 발송된다. 마우스의 X 자리 표는 
IParam 의 아래 단어 에 보관되 여 있으며 Y 자리 표는 Iparam 의 웃단어 에 보관되 여 있 다. 

pendown 이 TRUE 인 경 우는 사용자가 직 선을 그러 고 있 다. 이 경 우에 는 마우스가 
움직 일 때 마다 먼 저 현재 의 펜 이 창문의 장치상황 ( hdc ) 및 가상창문의 장치상황 
( memdc ) 에 선택된다. 

다음 마우스의 마지막 위치와 새로운 위치를 련결하는 직선이 두 장치상황에 그려진 
다. 이렇게 되여 마우스를 움직이면 원활하고 된 부분이 없는 직선을 련속적으로 그러는 
기능이 실현된다 . ( 시험적으로 LineToO 가 아니라 SetPixel () 을 사용하여 결과를 확인 
해 보라. WM_MOUSEMOVE 는 마우스를 움직이는 자러길의 모든 점에서 생성되지는 
않으므로 불련속적인 선으로 되여 버러고 마는것을 보게 될것이다.) 

직선이 그려 지면 도형의 현재위치가 현재마우스의 위치로 변경된다. 그것은 
LineTo ( ) 가 현재위치를 직선이 끝나는 점으로 변경하기때문이다. 

endpoint 가 TRUE 인 경우는 마우스가 4 각형 령역을 정의하는데 사용되고 있다. 
첫번째 정점은 WM_RBUTTONDOWN 통보문이 발송될 때 설정된다. 두번째 정점은 
WM_RBUTTONUP 통보문이 발송될 때 설정된다. 통보문의 LOWORD ( IParam ) 및 
HIWORD ( lParam ) 에 는 각각 마우스의 X , Y 자러 표가 보관되 여 있 다. 

마우스를 움직이면 현재령역의 크기를 보여 주는 4각형이 표시된다. 이 4각형은 창 
문과 XOR 연산된다. 이 렇게 하는 리유는 XOR 연산을 두번 진행하면 본래의 상태 로 복 
귀 되 기 때 문이 다. 출력방식 으로 X 2— XORPEN 을 사용한 첫 번째 Rectangle ( ) 의 호출이 4 
각형 을 표시 하고 그것 을 두번째 호출이 소거한다. 이 렇게 되 여 창문의 현재내 용을 잃지 
않고 4각형 을 그릴수 있 다. 
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|다시 한보 전진| 


불규직도형 (lllegular graphics ) 의 그리기 

Windows 2000 은 직선, 타원 및 4 각형 등의 기초도형만이 아니 라 불규칙적 
인 도형을 그리는 기능도 제공하고 있다. 이 러한 객체의 하나로서 다각형 이 있 
다. Windows 2000 에 있어서 다각형 이 란 세개 이상의 변을 가지는 닫긴 령역 이 다. 
다각형을 그리자면 Po 切 go /江乂함수를 사용한다. 선언은 다음과 같다. 

BOOL Polygon (HDC hdc , CONST POINT * vertices , int num ); 

hdc 에는 장치상황을 설정한다. 다각형의 매 정점을 보관하는 배럴을 
vertices 에 설정하고 정점의 수를 num 에 설정한다. 이 함수는 호출이 성공하면 
령 이 아닌 값을 돌려 주며 실패하면 령을 돌려 준다. 

다각형은 현재 선택된 펜으로 그려 지며 현재 선택되여 있는 붓으로 내부가 
칠해 진다. Polygon () 함수는 vertices 배렬의 마지막 점과 첫점을 련결하는 직선 
을 자동적으로 그리므로 닫긴도형으로 된다. Polygon ( ) 은 현재위치를 사용하지 
않으며 그 값을 갱신하지도 않는다. PolygonO 을 사용해 보려면 우선 다음과 같 
은 대역선언을 그리기프로그람에 추가해야 한다. 

POINT polygon [5] = { 

10 , 10 , 

10, 40, 

40， TO , 

40， 90, 

10, 10 }； 

다음으로 IDD_LINE 의 case 문에 아래 의 프로그람코드를 추가한다. 

Polygon (memdc, polygon, 5) : 

이 렇게 하면 [ Line ] 차림 표를 선택할 때 마다 5 각형 이 표시되게 된다. 

API 함수에는 이밖에도 복잡한 객체를 그리기 위한 API 함수들이 여러 개 있 
다. 대표적인 것은 Poly Line ( ), PolyLineTo ( ), Poly Poly Line ( ), 
PolyPolygon ( ), Poly Bezier ( ) 및 PolyBezierTo ( ) 등 이다. 
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세계변환의 사용법 


모든 판본의 Windows 는 그림그리 기 프로그람에 서 활용된 도형 기 능들을 제 공하고 
있다. 그러 나 Windows 2000 에는 Windows 95/98 에서는 지원되지 않는 강력 한 확장기 
능 즉 세계변환。' 있다. 세계변환이란 출력과 창문을 대응시키는 방법을 다양하게 변화 
시키는 변환기능을 실현하는것이다. 변환의 종류에는 회전, 이동, 축척，자름 및 반전 
등 이 있 다 . Windows 2000 을 사용하면 일 반적 인 CAD (Computer Aided Design ) 에 서 볼 
수 있는 복잡한 도형조작을 손 쉽게 실현할수 있다. 실례로 화상을 회전시키거나 확대할 
수 있다. 

Windows 2000 은 한 자리표공간을 다른 자리표공간으로 넘기기하여 세계변환을 실 
현한다. 여기서는 Windows 2000 의 자리표공간에 대 한 설명으로부터 시 작한다. 

자리표공간 

Windows 2000 은 세 가지 자리표공간을 정의 하고 있다. 첫번째 자리표공간을 세계자 
근/표공간이 라고 하며 이 자리표공간은 세계변환에서 사용된다. 두번째 자러표공간은 폐 
지 공간으로서 이것은 프로그람에서 사용되는 론러 자리 표공간이 다. 세 번째 자리 표공간은 
물리 적 자리표를 사용하는 장치공간느1사 물리 적장치 자체 에 대 응된 다. 물러적 장치 를 네 
번째 자리표공간이라고 부르기도 한다. 

알고 있는바와 같이 출력할 때 자리표는 론리단위 로 지정된다. 체 계설정의 단위는 
화소이 다. 그외에도 여 러가지 단위가 있다. 이 려한 단위들은 동시 에 한개의 자리표공간 
에서 한 물리적장치에 넘기기된다. 세계변환기능을 사용하지 않는 경우에는 출력의 넘기 
기 가 패지공간에서부터 개시된다. 세 계변환을 사용하는 경우에는 출력의 넘기 기가 세계 
공간에서 시작된다. 자리표공간이 바뀔 때는 앞의 자리표공간의 내용이 뒤의 자리표공간 
으로 넘기기된다. 

례 하면 屈07공간으로부터 장치공간에 로의 넘기기 에서는 론리 단위 가 물리 단위로 변환 
된다. 세계변환을 사용할 때는 세계공간으로부터 폐지공간에로의 넘기기가 미리 설정된 
변환방법 (회 전，축척 등)으로 된다. 

SetW 아 IdTransf 아 m( ) 

세 계 변환의 변환방법은 SetWorldTransforin ( M 入 ] 설정된다. 선언은 다음과 같다. 


BOOL SetWorldTransform (HDC hdc , CONST XFORM * lpTransform ) : 


hdc 는 변환을 진행 하는 장치 상황의 손잡이 이다. 변환방법 이 lpTransform 이 가리 
키는 구조체로 설정된다. 이 함수는 호출이 성공하면 령이 아닌 값을 돌려 주며 실패하 
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면 령을 돌려 준다. SetWorldTransform ( ) 을 호출한 다음에는 지정된 변환이 적용된다. 
변환방법은 교斤이구조체에서 지정된다. 정의는 다음과 같다. 


typedef struct tagXFORM 
{ 

FLOAT eMll ； 

FLOAT eM12 ； 

FLOAT eM21 ； 

FLOAT em22 ； 

FLOAT eDx ； 

FLOAT eDy ； 

} XFORM ； 

기본적인 변환방법은 XFORM 에서 정의된 행렬의 값에 의해 결정된다. 매개 변환이 
어떻 게 실현되는가를 설명해 보자. 

출력을 이동(원점을 이동)시키려면 X 축방향의 이동량을 eDx 에 설정하고 Y 축방향 
의 이동량을 eDy 에 설정 한다. 이동은 설정할수 있는 변환가운데서 가장 간단한 변환이 
다. 이동에 의해 출력위치가 옮겨 진다. 이동을 다른 변환과 조합시킬수도 있다. 

각도 比 ieta 만큼 출력을 회전시키기 위해서는 eMll , eM 12, eM 21 및 eM 22 을 아래의 
값으로 설정한다. 




eMll 

cos ( theta ) 

eM 12 

sin ( theta ) 

eM 21 

-sin ( theta ) 

eM 22 

cos ( theta ) 



출력 을 축척 하자면(확대 하거 나 축소하자면) X 축방향의 축척 률을 eMll 에 설정 하고 
Y 축방향의 축척률을 eM 22 에 설정 한다. eM 12 와 eM 21 은 사용하지 않는다. (령을 설정 
한다.) 

출력 을 자르기 하자면 (X 자리 표와 Y 자리 표를 바꾸어 축척 하자면 X 축방향의 자름률 
을 eM 12 에 설정 하고 Y 방향의 자름률을 eM 21 에 설정 한다. eMll 과 eM 22 은 사용하지 
않는다. (령 을 설정 한다. ) 

X 축에 대해 출력을 반전시키기 위해서는 eMll 에 -1 을 설정하고 eM 22 에 1을 설정 
한다.구축에 대해 출력을 반전시키기 위해서는 eM 22 에 -1 을 설정하고 eMll 에 1을 설 
정한다. 두 축에 대해서 출력을 반전시키기 위해서는 eMll 과 eM 22 에 -1 을 설정한다. 
eM 12 과 eM 21 은 사용하지 않는다. (령 을 설정 한다.) 
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XFORM 구조체의 성원에 여러가지 값을 설정하면 매우 다양한 변환을 할수 있다. 
매개 변환의 효과를 리해하기 위한 최량의 방법은 실제로 시험해 보는것이다. 


도형방식의 설정 

SetWorldTransform( ) 의 기 능을 사용하자면 SetGraphicsMode ( ;함수를 사용하여 
사전에 Windows 2000 의 확장도형 방식을 유효하게 해 야 한다. 선언은 다음과 같다. 


int SetGraphicsMode (HDC hdc, int GraphMode) : 


hdc 에는 대상으로 되는 장치상황의 손잡이를 설정 하고 GraphMode 에 목적 하는 도 
형방식을 설정 한다. 이 값은 GM_COMPATIBLE 혹은 GAG4 公竹 4iVC 표의 어 느 한 값이 여 
야 한다. 이 함수는 바로 전에 설정되 여 있던 방식 을 돌려 주며 호출이 실패하면 령 을 
돌려 준다. 

체 계설정의 도형 방식 은 GM—COMPATIBLE i 된다. 이것은 Windows 95/98 에서도 
사용되는 방식이다. SetWorldTransf orm ( ) 을 사용하려면 도형방식을 GM_ADVANCE 
에 설정하여 야 한다. 

그림그리기프로그람에 회전기능을 추가 

SetWorldTransform( ) 의 사용방법을 리해하기 위해 그림그리기프로그람의 기능을 
확장하여 그린 화상을 회전할수 있게 해 보자. 

왼쪽화살건을 누를 때마다 현재 표시되여 있는 화상이 시계바늘회전방향의 반대방향 
으로 30 ° 씩 회 전한다. 오른쪽 화살건을 누를 때마다 화상이 시계바늘회전방향으로 30° 씩 
회전한다. 어느 경우에나 의뢰자구역의 중심을 회전중심으로 하여 화상이 회전한다. 프로그 
람코드를 실례 9-2 에 보여 주었다. 프로그람의 실행결과는 그림 9-3 에 보여 주었다. 

실례 9-2. Rotation 프로그람 


// SetWorldTransform( ) 을 리용한 화상의 회전 


ttinclude 〈 windows. h> 
^include "graph, h” 
ttinclude <cmath> 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM); 
char szWinNameG = n MyWin”; // 창문클라스의 이름 
int maxX, maxY; // 화면의 크기 
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HDC memdc ； // 기억기장치상황의 손잡이 
HBITMAP hbit ； // 호환성 있는 비트매프의 손잡이 
HBRUSH hCurrentbrush, hOldbrush; // 붓의 손잡이 
HBRUSH hRedbrush, hGreenbrush, hBluebrush, hNullbrush ； 

// 펜의 작성 

HPEN hOldpen ； // 펜의 손잡이 

HPEN hCurrentpen ； // 현재 선택되여 있는 펜 

HPEN hRedpen, hGreenpen, hBluepen, hBlackpen ； 

int X=0, Y=0; 
int pendown = 0 ； 
int endpoints = 0 ； 

int StartX=0, StartY=0, EndX=0, EndY=0 ； 
int Mode ； 

int theta = 0 ； // 회전각도 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 

// 창문믈라스률 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ； 


wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ； // 큰 아이 콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC.ARROW) ； // 유표의 형 식 
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wcl. IpszMenuName = "GraphMenu" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 

// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


A 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow( 
szWinName, // 창문믈라스의 이름 
"Paint With Rotation", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자리 표는 Windows 가 결 정 하게 한다 . 
CWJJSEDEFAULT, // Y 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너비는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림 표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메터는 없 다 . 

)； 


// 건반가속기를 적재 한다 . 

hAccel = LoadAccelerators(hThisInst, "GraphMenu") : 

// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) ; 

UpdateWindow (hwnd ); 


II 통보문순환고리를 작성한다 . 
while(GetMessage(&msg , NULL, 0, 0)) 
{ 
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if( ! TranslateAccelerator(hwnd, hAccel, &msg)) { 
TranslateMessage(&msg) ； // 건반통보를 변환한다 . 
DispatchMessage(tosg) ; // Windows 2000 에 조종을 넘 긴다 . 

} 


return msg. wParam ； 

} 


/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 

PAINTSTRUCT paintstruct ； 
int response ； 

RECT rect ； 

XFORM tf ； // 변환행렬 


switch (message) { 
case WM.CREATE ： 

// 화면의 크기를 엄는다 . 

maxX = GetSystemMetrics(SM_CXSCREEN) ； 

maxY = GetSystemMetrics(SM_CYSCREEN) ； 

// 가상창문을 작성한다 . 

hdc = GetDC(hwnd) ； 

memdc = CreateCompa 切 bleDC(hdc); 

hbit = CreateCompatibleBitmap(hdc, maxX, maxY); 

SelectObject (memdc, hbit) ； 

hCurrentbrush = (HBRUSH) GetStockObject(WHITE_BRUSH) ； 
SelectObject (memdc, hCurrentbrush) ； 

PatBlt (memdc, 0, 0, maxX, maxY, PATCOPY); 

// 펜을 작성한다 . 

hRedpen = CreatePen(PS_SOLID, 1, RGB(255,0,0)) ； 
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hGreenpen = CreatePen(PS_SOLID, 1, RGB(0,255,0)) ； 
hBluepen = CreatePen(PS_SOLID, 1, RGB(0,0,255)) ； 

// 붓을 작성 한다 . 

hRedbrush = CreateSolidBrush (RGB (255,0,0 ))； 
hGreenbrush = CreateSolidBrush (RGB (0,255,0)) ； 
hBluebrush = CreateSolidBrush (RGB (0,0,255)) ； 
hNullbrush = (HBRUSH) GetStockObject(HOLLOW_BRUSH); 


// 체계설정의 펜을 보관한다 . 

hBlackpen = hOldpen = (HPEN) SelectObject (memdc, hRedpen) ； 
hCurrentpen = hOldpen; 

SelectObject (memdc, hOldpen) ； 


ReleaseDC (hwnd, hdc) ； 
break ； 

case WM.KEYDOWN ： // 화상을 회 전한다 . 
switch ((char) wParam) { 
case VK.LEFT ： // 시계바늘의 반대방향 
theta -= 30; 

InvalidateRect (hwnd, NULL, 1); 
break ； 

case VK.RIGHT ： // 시계바늘 방향 
theta += 30; 

InvalidateRect (hwnd, NULL, 1); 
break ； 

} 

break ； 

case WM.RBUTTONDOWN : // 령역의 정의를 개시한다 . 
if (theta) { // 화면을 원상태로 복귀한다 . 
theta = 0; 

InvalidateRect (hwnd, NULL, 1); 

} 

endpoints = 1 ； 

X = StartX = LOWORD(lParam) ； 

Y = StartY = HIWORD(lParam) ； 
break ； 

case WM.RBUTTONUP ： // 령역의 정의를 끝낸다 . 
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endpoints = 0 ； 

EndX = LOWORD(lParam); 

EndY = HIWORD(lParam) ； 
break ； 

case WM.LBUTTONDOWN : // 그리기를 개시한다 . 
if (theta) { // 화면을 원상태로 복귀한다 . 
theta = 0 ； 

InvalidateRect (hwnd, NULL, 1); 

} 

pendown = 1 ； 

X = LOWORD(lParam) ； 

Y = HIWORD(lParam) ； 
break ； 

case WM.LBUTTONUP ： // 그리 기 를 끝낸다 . 
pendown = 0 ； 
break ； 

case WM.MOUSEMOVE ： 
if (pendown) { // 그린 다 . 
hdc = GetDC(hwnd) ； 

SelectObject (memdc, hCurrentpen); 

SelectObject (hdc, hCurrentpen) ； 

MoveToEx (memdc, X, Y, NULL) ； 
MoveToExChdc, X, Y, NULL) ； 

X = LOWORD(lParam) ； 

Y = HIWORD(lParam); 

LineTo(memdc, X, Y) ； 

LineTo(hdc, X, Y )； 

ReleaseDC(hwnd, hdc); 

} 

if (endpoints) { // 령역을 둘러싸는 선을 표시한다 . 
hdc = GetDC(hwnd) ； 

// 점선을 그리는 펜을 선택한다 . 

hOldpen = (HPEN) SelectObject (hdc, hRedpen) ； 

// 출력방식을 XOR 로 변경한다 . 

Mode = SetROP2(hdc, R2.XORPEN) ； 
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// 그리기를 하지만 색칠하지는 않는다. 
hOldbrush = 


(HBRUSH) SelectObject(hdc, GetStockObject(HOLLOW_BRUSH)) ; 


// 낡은 점선 4각형을 소거한다. 

Rectangle (hdc, StartX, StartY, X, Y); 

X = LOWORD(lParam) ； 

Y = HIWORD(lParam) ； 

// 새로운 점선 4 각형을 그린다. 

Rectangle (hdc, StartX, StartY, X, Y); 

// 체계설정의 붓으로 복귀한다. 

SelectObject (hdc, hOldbrush) ； 
SelectObject (hdc, hOldpen) ； 
SetROP2(hdc, Mode) ； 

ReleaseDC (hwnd, hdc); 

} 

break； 

case WM.COMMAND： 
switch (LOWORD (wParam)) { 
case IDM.ROTATERESET : 
theta = 0； 

InvalidateRect (hwnd, NULL, 1); 
break； 

case IDM—LINE: 

// 현재의 펜을 선택한다. 

SelectObject (memdc, hCurrentpen); 


// 직선을 긋는다. 

MoveToEx (memdc, StartX, StartY, NULL) ； 
LineTo(memdc, EndX, EndY) ； 

InvalidateRect (hwnd, NULL, 1); 
break； 

case IDM.RECTANGLE： 

// 붓과 펜을 선택한다. 
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SelectObject (memdc, hCurrentbrush) ； 


SelectObject (memdc, hCurrentpen) ； 


// 4 각형을 그린다. 

Rectangle (memdc, StartX, StartY, EndX, EndY) ； 

InvalidateRect (hwnd, NULL, 1); 
break； 

case IDM_ELLIPSE: 

// 붓과 펜을 선택한다. 

SelectObject (memdc, hCurrentbrush) ； 

SelectObject (memdc, hCurrentpen); 


// 타원을 그린다. 

Ellipse(memdc, StartX, StartY, EndX, EndY); 

InvalidateRect (hwnd, NULL, 1); 
break； 

case IDM 一 RED: 
hCurrentpen = hRedpen； 
break； 

case IDM_BLUE: 
hCurrentpen = hBluepen； 
break； 

case IDM_GREEN : 
hCurrentpen = hGreenpen; 
break； 

case IDM 一 BLACK: 
hCurrentpen = hBlackpen； 
break； 

case IDM 一 REDFILL: 
hCurrentbrush = hRedbrush； 
break； 

case IDM.BLUEFILL： 
hCurrentbrush = hBluebrush； 
break； 

case IDM.GREENFILL： 
hCurrentbrush = hGreenbrush； 
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break； 

case IDM.WHITEFILL： 
hCurrentbrush = hOldbrush； 
break； 

case IDM_NULLFILL: 
hCurrentbrush = hNullbrush； 
break； 

case IDM_RESET: 

// 현재위치를 (0, 이으로 재설정한다. 

MoveToEx(memdc, 0, 0, NULL); 

// 배경을 칠하여 소거한다. 

SelectObject (memdc, hOldbrush) ； 

PatBlt (memdc, 0, 0, maxX, maxY, PATCOPY) ； 

theta = 0； 

InvalidateRect (hwnd, NULL, 1); 
break； 

case IDM_EXIT： 

response = MessageBox(hwnd, ” Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O) ； 
break； 

case IDM_HELP： 

MessageBox (hwnd, ”F2: Line\nF3： Rectangle \ n" 

”F4: Ellipse \nF5： Rotation Reset \n” 

” F6: Reset \n n , 

” Paint and Rotate”, MB_OK) ； 

break； 

} 

break； 

case WM.PAINT： // 다시그러 기요구를 처 리 한다. 
hdc = BeginPaint(hwnd, &paintstruct) ； // 장치 상황을 얻 는다. 

// Windows 2000 곽장도형 방식을 사용한다. 

SetGraphicsMode (hdc, GM.ADVANCED) ; 
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// 의뢰자구역의 현재크기를 얻는다. 
GetClientRect (hwnd, &rect) ； 


// 화상을 회전시킨다. 

tf.eMll = (float) cos (theta * 3.1416/180); 
tf.eM12 = (float) sin(theta * 3.1416/180) ； 
tf.eM21 = (float) -sin(theta * 3.1416/180); 
tf. eM22 = (float) cos (theta * 3.1416/180); 
tf.eDx = (float) rect.right/2 ； 
tf.eDy = (float) rect. bottom/2 ； 

SetWorldTransform(hdc, &tf) ； // 변환을 설정 한다. 

// 가상창문을 화면에 복사한다. 

BitBlt(hdc, -rect. right/2, -rect. bottom/2, 

rect. right, rect. bottom, memdc, 0, 0, SRCCOPY); 

EndPaint(hwnd, &paintstruct) ； // 장치 상황을 해제 한다. 
break； 

case WM.DESTROY ： // 프로 그람을 끝낸다. 
DeleteObject(hRedpen) ； // 펜을 삭제 한다. 

DeleteOb ject (hGreenpen) ; 

DeleteOb ject (hBluepen); 

DeleteOb ject (hBlackpen); 


DeleteOb ject (hRedbrush) ； // 붓을 삭제 한다. 
DeleteOb ject (hGreenbrush) ； 

DeleteOb ject (hBluebrush) ； 


DeleteDC (memdc) ； 

DeleteOb ject (hbit) ； 

PostQuitMessage (0) ； 
break； 
default： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다. */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 

} 
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return 0 ； 

} 

이 프로그람은 다음의 자원파일을 사용한다. 

#include < windows. h> 

^include "graph, h” 


GraphMenu MENU 

{ 

POPUP M &Shapes M 

{ 

MENUITEM ” &Line\tF2" ， IDM.LINE 
MENUITEM '^Rectangle \tF3 M , IDM_RECTANGLE 
MENUITEM '^Ellipse \tF4 M , IDM_ELLIPSE 
MENUITEM n E&xit\tCtrl+X H , IDM.EXIT 

} 

POPUP ” ^Options” 

{ 

POPUP ，，& Pen Color ，， 

{ 

MENUITEM M &Red M , IDM.RED 
MENUITEM n &Blue n , IDM_BLUE 
MENUITEM ，， & Green", IDM.GREEN 
MENUITEM "Bl&ack”, IDM.BLACK 

} 

POPUP "&Fill Color" 

{ 

MENUITEM "&Red M , IDM.REDFILL 
MENUITEM ，，技 Blue，，, IDM_BLUEFILL 
MENUITEM "&Green", IDM.GREENFILL 
MENUITEM ”&White”, IDM_WHITEFILL 
MENUITEM ’Wull”, IDM.NULLFILL 

} 

MENUITEM "Ro&tation Reset \tF5 M , IDM.ROTATERESET 
MENUITEM ” &Reset\tF6”, IDM.RESET 
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MENUITEM ” &Help", IDM.HELP 

} 


GraphMenu ACCELERATORS 

{ 

VK_F1, IDM_HELP, VIRTKEY 
VK_F2, IDM.LINE, VIRTKEY 
VK_F3, IDM.RECTANGLE, VIRTKEY 
VK_F4, IDM_ELLIPSE, VIRTKEY 
VK_F5, IDM_ROTATERESET, VIRTKEY 
VK_F6, IDM.RESET, VIRTKEY 
『 X", IDM_EXIT 

} 

GRAPH.H 에는 다음 행을 추가한다. 

Mefine IDM.ROTATERESET 200 



그림 9-3. 회전프로그람의 실행결과 
교육성 프로그람교육쎈터 
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화상을 회전시키는 절차 

화상을 회전시키기 위해 그림그리기프로그람에 다음의 내용을 추가한다. 

• 도단위로 현재회전각도를 보관하는 대역변수 theta 

• 현재의 변환행렬을 보관하는 국부변수 tf 

• 건 이 눌러 울 때 마다 30°씩 仕 ieta 를 증감하는 왼쪽 화살건과 오른쪽 화살건의 
처리 

• WM—PAINT 에 서 SetWorldTransform ( ) 의 호출 

• [Rotation Reset ] 차림표 


이것들이 어떻게 작용하는가를 설명한다. tiieta 의 값은 WM_PAINT 가운데서 가상 
창문 ( memdc ) 으로부터 물러장치 상황 ( hdc ) 에 화상이 복사될 때 적 용되 는 각도를 결정 한 
다. VK_LEFT 및 VK_RIGHT 의 처 리 에서 는 건이 눌러울 때마다 theta 의 값을 증가하 
거 나 감소시 키 고 창문이 다시그리 기 된 다. 

실제로 화상을 회전하는 처리는 아래에 준 WM_PAINT 안에서 진행된다. 프로그람 
코드의 내 용을 상세하게 조사해 보자. 

case WM_PAINT: // 다시그리 기요구를 처 리 한다 . 
hdc = BeginPaint (hwnd, &paintstruct) : // 장치 상황을 얻 는다 . 

// Windows 양 )00 확장도형 방식 을 사용한다 . 

SetGraphicsMode(hdc, GM_ADVANCED) : 


// 의뢰자구역의 현재크기를 얻는다 . 
GetClientRect (hwnd, &rect) ; 


// 화상을 회전시킨다 . 

tf.eMll = (float) cos (theta * 3.1416/180); 
tf. eM12 = (float) sin (theta * 3.1416/180 )； 
tf. eM21 = (float) -sin(theta * 3.1416/180); 
tf.eM22 = (float) cos (theta * 3.1416/180); 
tf.eDx = (float) rect.right/2; 
tf.eDy = (float) rect.bottom/2 ； 

SetWorldTransform(hdc, 射 f); // 변환을 설정 한다 . 
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// 가상창문을 화면에 복사한다 . 

BitBlt(hdc, -rect. right/2, -rect. bottom/2, 

rect. right, rect. bottom, memdc, 0, 0, SRCCOPY) : 

EndPaint(hwnd, &paintstruct); // 장치 상황을 해 제 한다 . 
break ； 


WM_PAINT 통보문을 받아 들일 때 마다 장치상황이 얻어지며 확장도형 방식 이 설정 
된다. 의 뢰 자구역의 현재크기 가 얻어지고 theta 에 보관된 각도로 회 전을 진행 하기 위 한 
변환행렬이 설정된다. 

C 八>+표준함수로 시누스나 코시누스값을 구하는 경우에는 각도를 rad 단위 로 설정 
한다. 그래서 함수의 파라메 터에는 仕 ieta 를 ° 단위로부터 rad 단위 에로 변환하는 수식 이 
들어 있 다. 比 ieta 가 령 (이 것 이 초기 값이다. ) 인 때 는 회 전을 진행 하지 않는다. 

변환행 렬에서 eDx 에 rect . right /2 를 설정 하고 eDy 에 rect . bottom /2 를 설정 한데 
주목해야 한다. 모든 변환은 원점을 중심으로 진행된다. 원점은 체계설정에서는 창문의 
왼쪽 웃모서리로 되여 있다. 이것을 각각 창문의 의뢰자구역의 너비와 높이의 1/2 로 하 
여 변환의 원점이 창문의 중심으로 된다. 이렇게 되여 창문중심주위로의 회전이 진행되 
게 된다. 

SetWorldTransform ( ) 이 호출되면 지정된 변환이 유효하게 되며 그후의 출력에 적 
용된다. WM_PAINT 내 에서 가상창문의 내 용을 물리 창문에 복사할 때 BitBlt ( ) 를 호출 
하면 회전변환이 자동적으로 진행된다. 

BitBltC ) 를 호출하는 부분을 잘 살펴 보자. 복사측의 왼쪽웃모서 리 를 지 정 하는 값이 
(0, 0) 이 아니라 - rect . right /2 와 - rect . bottom /2 로 되여 있다. 이것은 변환의 원점 이 
창문크기의 절반만큼 이동하였기때문이 다. 가상창문으로부터 복사할 때 이 보정 이 필요 
하게 된다. 

처음의 회전되지 않은 상태로 화상을 복귀하려면 [ Option ] 차림표로부터 [Rotation 
Reset ] 를 선택한다. 이 차림표항목은 吐 ieta 에 령을 설정한 다음 창문을 다시그리기한다. 
이 처리는 마우스의 왼쪽 혹은 오른쪽 단추를 누를 때 진행된다. 

자체로 해보기 

그림그리기프로그람에 다음의 확장기능을 추가해 보라. 일반 4 각형과 모서리가 원활한 
4 각형 을 선택 하는 기 능，부채 형 을 그리 는 기 능, 창문을 부분적 으로 소거 하는 기능, 선의 너 
비를 선택하는 기능， SetWorldTransform () 이 지 원하는 다른 변환기능 그리고 [ Option ] 차 
림표에 [ Undo ] 를 추가하고 그것으로 방금 진행한 그리기처리를 취소하는 기능. 


교육성 프로그람교육멘터 


313 



Windows 2000 프로그람작성법 


넘기기방식과 보임참 


이 장을 끝내 기 에 앞서 Windows 2000 의 도형 체 계 의 두가지 기 능을 추가적 으로 설 
명해 둔다. 그것은 넘기기방식과 보푠/장이 다. 

본문이 나 도형관련의 API 함수에서 론리단위 A 사용된다는것은 이미 배웠다. 론리 단 
위는 객체가 표시될 때 Windows 에 의해 물리단우1(、이 7 文은 화소이다.)로 변환된다. 론 
리단위로부터 물리단위 에 로의 변환비률은 현재의 넘기기방식 에 의해 결정된다. 

그러므로 넘기기방식은 폐지공간의 단위 가 장치공간에서 얼마로 되는가를 결정하는 
것 으로 된다. (넘 기 기 방식 자체 에는 앞에서 설명 한 여 러 가지 변환을 진행 하는 기능은 없 
다.) 넘기기방식은 원점의 위 치 에도 영 향을 준다. 

론러단위와 물리 단위의 변환에 관계되는 속성 에는 넘기기방식만이 아니 라 다른 두가 
지 속성 이 더 있다. 첫 속성은 선택한 론리단위로 창문의 너 비와 높이를 정의하는것 이 다. 
두번째 속성은 몇가지 넘기기방식에서 보임창의 물리적크기 를 결정하는것 이 다. 

보임 창이 란 장치공간에서 정의되는 4 각형 령 역 이 다. 보임창의 크기는 론러단위 로부 
터 물리단위에로의 축척률을 결정하는 요인으로 된다. 출력은 보임창의 경계선내에 들어 
가도록 넘기기된다. 거의 모든 넘기기방식에서는 보임창의 크기가 미리 정의되여 있으므 
로 변경할수 없다. 그러 나 보임창의 크기를 결정할수 있는 두가지 넘 기기방식 이 있다. 
보임 창의 원점 을 설 정할수도 있 다. 

넘기기방식의 설정 

체계설정으로 론리단위는 화소와 같다. 그러므로 론리단위로부터 화소에로의 변환비 
률은 체계설정 으로 1대 1 이 다. 그러 나 넘기기방식을 변경하여 이 변환비률을 바물수 있 
다. 현재의 넘기기 방식을 변경하려면 SetMapModeC ) 를 사용한다. 선언은 다음과 같다. 

int SetMapMode(HDC hdc , int mode ); 


hdc 에는 장치상황의 손잡이를 설정 한다. mode 에는 새로운 넘기기 방식을 설정 한다. 
넘기기방식은 아래의 값중에서 임의의 값을 설정한다. 


MM_ANISOTROPIC 

각 론러단위는 임의로 축척된 자리표축상의 임의의 단위 
로 넘기기된다. 

MM HIENGLISH 

각 론리단위 는 O.OOlinch 로 넘 기 기 된 다. 

MM.HIMETRIC 

각 론리 단위는 0.01 mm 로 넘기기된다. 

MM ISOTROPIC 

각 론리단위는 균등하게 축척된 임의의 단위로 넘기기된 
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다.(즉 X 축과 Y 축의 축척 이 같다. ) 

MM LOMETRIC 

각 론리단위 는 0.1 mm 로 넘 기 기 된 다. 

MM.LOENGLISH 

각 론리단위 는 O.Olinch 로 넘 기 기 된 다. 

MM.TEXT 

각 론리 단위 는 장치 의 1 화소에 넘 기 기 된 다. 

MM.TWIPS 

각 론리 단위는 1/20 포인트(약 l /1440 inch ) 로 넘기기된다. 


An nr 에서는 x 축의 방향이 오른쪽 방향으로 되고 구축의 방향이 아래방향으로 
된다. MM - ANISOTROPIC 와 Ad /5 公: Ti ? 幻 P/C 에서는 X 축과 Y 축의 방향을 임의로 설정 
할수 있다. 기 타의 넘기기방식 에서는 일반직각자리 표계 와 같이 X 축의 방향이 오른쪽 방 
향이며 Y 축의 방향이 웃방향으로 된다. 

SetMapMode () 는 함수를 호출하기 전의 넘기기방식을 돌려 주며 오유가 발생한 경 
우에는 령을 돌려 준다. 체계설정의 넘기기방식은 MM_TEXT 이 다. 

현재의 넘기기방식을 변경하는데는 몇 가지 목적 이 있다. 례하면 프로그람의 출력을 
물리 단위 로 표시하려 는 경 우에 는 MM_LOMETRIC 등과 같이 현실세 계 와 꼭 같은 방식 
을 선택한다. 

프로그람에서 표시하는 정보내용의 형식에 가장 부합되게 단위를 정의하려는 경우도 
있다. 표시되는 정보내용의 축척을 변경하려는 경우도 있다 .( 출력내용의 크기를 확대하 
거나 축소하려는 경우이다.) X 축과 Y 축의 축척을 갈게 하려는 경우도 있다. 이렇게 하 
면 X 축과 Y 축에서 표시되는 단위가 를리적으로 같게 된다.) 

참문범위의 정의 

MMJSOTROPI (요 MM _ ANISOTROPIC 호\ 어느 한 방식을 선택한 경우에는 창문의 
범위를 론러 단위 로 정의 하여 야 한다. ( MMJSOTROPIC 와 MM_ANISOTROPIC 에서는 임 
의 의 단위 를 사용하므로 제 한을 정 의 하여 야 한다. ) 창문의 X 축방향 및 Y 축방향의 범 위 
를 정 의 하자면 SetWindowExtEx () 함수를 사용하여 야 한다. 선언은 다음과 같다. 

BOOL SetWindowExtEx (HDC hdc , int Xextent , int Yextent , 

LPSIZE lpOldSize ) : 

hdc 에 는 장치 상황의 손잡이 를 설정 한다. Xextent 와 Yextent 에 는 새 로운 X 축방향 
과 Y 축방향의 범위 를 론리단위 로 설정한다. 이 함수를 호출하기 전의 창문의 범위 가 
lpOldSize 가 가리 키는 Size 구조체 에 돌려 진다. 그러 나 lpOldSize 가 NULL 인 경우는 
마지막으로 설정되였던 범위가 돌려 지지 않는다. 호출이 성공하면 함수는 령이 아닌 값 
을 돌려 주며 실패하면 령을 돌려 준다. SetWindowExtEx ( ) 는 넘기기방식이 
MM_ANISOTROPIC 또는 MMJSOTROPIC 인 경우에 만 사용된다. 

창문의 론리크기를 변경한다고 하여 화면에 표시되는 창문의 물리크기까지 변경되지 
는 않는다는데 주의 해 야 한다. 선택 한 론리 단위 로 창문의 크기 를 정의 할뿐이 다. (보다 정 
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확히 말하면 창문에 서 사용되 는 론리단위 와 장치 에 서 사용되 는 물리단위 (화소)의 관계 
를 정의할뿐이다.) 

실례 로 같은 창문에 론리적크기 로 100,100을 줄수도 있고 50 Z 75를 줄수도 있다. 
이 두 설정 의 차이 는 화상이 표시 될 때 론리단위 로부터 화소에 로의 변환비 률뿐이 다. 

보임참의 정의 

이미 설명한바와 같이 보임창은 론리단위를 물리장치로 어떻게 넘기기하는가를 결정 
하는 요인으로 되 며 장치공간내 에 있는 4 각형 구역 이 다. 보임 창의 크기 는 론리단위 를 화 
소로 변환하기 위해 사용되는 변환비률의 물리 적 인 요소를 정 의한다. (창문의 범 위는 론 
리 적 인 요소를 정 의한다. ) 

일반적 인 넘기기방식 에서는 보임창의 크기 가 고정되 여 있으므로 프로그람에서 변경 
시킬수 없다. 그러나 MMJSOTROPIC 및 MM_ANISOTROPIC 에서는 보임창의 크기를 
변경시 킬수 있다. 이 넘기기방식들에서는 론리단위로부터 화소에 로의 변환비률을 설정할 
수 있기때문이다. 

보임 창은 SetViewportExtExC ) 항수를 사용하여 정의된다. 선언은 다음과 같다. 

BOOL SetViewportExtEx (HDC hdc , int Xextent , int Yextent , 

LPSIZE lpOldSize ); 

hdc 에 는 장치상황의 손잡이를 설정 한다. Xextent 와 Yextent 에 는 X 축방향 및 Y 
축방향의 보임 창의 새 로운 크기 를 화소단위 로 설정한다. 함수의 호출이 성 공하면 령 이 
아닌 값을 돌려 주며 실패하면 령을 돌려 준다. 함수를 호출하기 전의 보임창의 크기가 
lpOldSize 가 가리키는 SIZE 구조체에 돌려 진다. 그러나 lpOldSize 를 NULL 로 하면 바 
로 이전의 크기가 돌려 지지 않는다. 


참 고 : SetViewportExtEx ( ) -t 대 응 방 식 이 MMJSOTROPIC 또 는 MM _ 
ANISOTROPIC 인 때 만 사용된다. 


보임창은 임의의 크기 로 설정할수 있다. 창문전체 를 포함하는 크기 로 할수도 있고 
창문보다 크게 할수도 있으며 혹은 창문의 일부분으로 할수도 있다. 

출력은 폐지공간(론리단위)으로부터 보임창(화소)으로 자동적 으로 넘기기되며 그에 
맞게 축척 된다. 그러 므로 보임 창의 X 축 방향 및 Y 축 방향의 크기 를 변경 하는것 은 론리 
단위 로부터 화소에 로의 변환비 률을 변경 하는것 으로 된다. 

이 결과로서 표시되여 있는 모든 내용의 크기가 변한다. 보임창의 크기를 크게 하면 
보임창의 내용이 확대된다. 이와는 반대로 크기를 작게 하면 보임창의 내용이 축소된다. 
이 기능은 화상의 축소나 확대에서 편리하게 리용된다. 
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보임참원점의 설정 

체 계 설 정 으 로 는 보 임 창 의 원 점 이 창 문 의 (0， 0) 위 치 에 있 다 . 그 러 나 
SetViewportOrgEx( ) 를 사용하면 원점의 위 치를 변경 할수 있다. 선언은 다음과 같다. 

BOOL SetViewportOrgEx(HDC hdc , int X , int Y , LPPOINT lpOldOrg ) : 
hdc 에 장치상황의 손잡이를 설정한다. 보임창의 새로운 원점을 X , Y 에 화소단위로 
설정 한다. 직전의 원점 이 lpOldOrg 가 가리 키는 POINT 구조체 에 돌려 진다. 이 파라메 
터를 NULL 로 하면 직전의 원점은 돌려 지지 않는다. 호출이 성공하면 함수는 령 이 아 
닌 값을 돌려 주며 실패하면 령 을 돌려 준다. 

보임창의 원점을 변경하면 창문에 표시되는 화상의 위치가 변한다. 

보임 창과 넘기기방식의 실례프로그람 

실례 9-3 의 프로그람은 넘기기방식과 보임창의 실례 이 다. 이 프로그람에서 진행되 
는 처리는 매우 간단하다. 

우선 WM_PAINT 내 에서 넘기기 방식을 MM_ANISOTROPIC 로 설정 하고 창문의 범 
위 를 200 / 200 으로 설정 하며 보임 창의 크기 를 변수 Xext 및 Yext 에 설정 하고 보임 창의 
원점 을 변수 Xorg 및 Yorg 에 설 정한다. 

다음 어떤 화상을 그린다. 마우스의 왼쪽 단추를 누를 때마다 원점이 이동한다. 마 
우스의 오른쪽 단추를 누를 때마다 보임창의 크기가 커지게 된다. 원점을 이동하면 창문 
안에 그려진 화상이 이동한다. 보임창의 크기를 크게 하면 화상이 확대된다. 프로그람의 
실행결과를 그림 9-4 에 준다. 

실례 9-3. Viewport 프로그람 


// 넘기기방식과 보임창의 실례 


ttinclude < windows. h> 
ttinclude <cstring> 
ttinclude <cstdio> 


LRESULT CALLBACK WindowFunc (HWND, UINT, WPARAM, LPARAM) ； 

char szWinName[] = n MyWin，，; // 창문클라스의 이름 
// 보임창의 크기와 원점 
int Xext=50, Yext=50; 
int Xorg=0, Yorg=0 ； 
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int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 


// 창문콜라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ; 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 

wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계 설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이론 
wcl. hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl.lpszMenuName = NULL ； // 콜라스차림표는 없다 . 
wcl.cbClsExtra = 0 ； // 보조기 억기령역은 필요 없다 . 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 

// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문물라스가 등록되 였 으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Mapping Modes and Viewports", // 제목 
WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
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CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림 표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메터는 없 다 . 

)； 


// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) ; 
UpdateWindow (hwnd ); 


// 통보문순환고리를 작성 한다 . 

while(GetMessage(&msg , NULL, 0, 0)) 

{ 

TranslateMessage(&msg); // 건반통보를 변환한다 . 
DispatchMessage(&msg) : // Windows 2000 에 조종을 넘 긴다 . 

} 

return msg. wParam ； 

} 


/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 

PAINTSTRUCT paintstruct ； 
char str[80] : 


switch (message) { 

case WM_RBUTTONDOWN : // 보임 창의 크기를 확장한다 . 
Xext += 10 ； 

Yext += 10 ； 

InvalidateRect (hwnd, NULL, 1); 
break ； 

case WM_LBUTTONDOWN : // 원점을 이동한다 . 
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Xorg += 10; 

Yorg += 10 ； 

InvalidateRect (hwnd, NULL, 1); 
break ； 

case WM_PAINT ： 

hdc = BeginPaint(hwnd, &paintstruct) ； // 장치 상황을 얻 는다 . 

sprintf(str, "Viewport extents ： %d %d, origin ： %d %d”, 

Xext, Yext, Xorg, Yorg) ； 

TextOut(hdc, 50, 0, str, strlen(str)) ； 

// 넘기기방식을 설정한다 . 

SetMapMode(hdc, MM_ANISOTROPIC) ； 


// 창문의 크기와 보임창의 크기를 설정한다 . 

SetWindowExtEx(hdc, 200, 200, NULL) ； 
SetViewportExtEx(hdc, Xext, Yext, NULL) ； 

// 보임창의 원점을 설정한다 . 

SetViewportOrgEx(hdc, Xorg, Yorg, NULL) ； 

// 몇개의 객체를 그린다 . 

LineTo(hdc, 50, 50); 

Rectangle (hdc, 20, 20, 80, 80); 

Ellipse (hdc, 40, 50, 100, 120); 

EndPaint(hwnd, &paintstruct) ； // 장치 상황을 해 제 한다 . 
break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리 률 맡긴 다 . */ 
return DefWindowProc(hwnd, message, wParam, lParam); 

} 

return 0 ； 

} 
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도형장치대면부의 실험 

자리표공간，세 계변환，보임창 및 넘기기방식 등 이 장에서 설명된 개 념들가운데는 
직 관적 으로 리해 하기 힘 든것 들도 있 다. 이 기 능들과 도형장치 대 면부 (GDI : Graphics 
Device Interface ) 전반에 숙련되기 위한 최량의 방법은 여러가지 기능을 실제로 시험해 
보는 간단한 프로그람들을 많이 작성해 보는것이다. 세계변환 및 기타 기능들을 잘 익혀 
두면 응용프로그람들에서 효률적으로 활용할수 있다. 
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제 10 장 


공들조종체와 공■대화칸 


이 장에서는 Windows 2000 의 가장 우수한 기능의 하나인 공통조종제아 대 
한 설명을 시작한다. 지금까지의 장들에서는 누름단추 (Push button ) , 흘림띠， 
검 사칸 등의 표준적 인 조종체 들의 사용방법 에 대 하여 설 명하였 다. 이 밖에 도 
Windows 2000 은 세 련된 양식의 고급한 기 능을 가진 조종체 들도 제 공하고 있 다. 

이 조종체들을 사용하면 프로그람의 사용자대면부를 보다 세련되게 할수 있 
다. 즉 사용자의 기대를 충분히 만족시 키는 고급한 웅용프로그람을 작성할수 있 
다. 공통조종체가 Windows 2000 프로그람작성에서 매우 중요한 요소이므로 여 
러장에 걸쳐 설명하기로 한다. 

이 장에서는 Windows 의 두개의 공통대 화칸에 대 하여서도 설명 한다. 

공통대화칸이한 프로그람에서 자유로이 사용되는 미 리 정의된 대화칸이며 이 
것을 사용하면 다음의 두가지 우점 이 있다. 

첫째 우점은 공통대화칸이 많은 프로그람의 입력처리에서 공통적으로 사용되 
는 통일적 인 사용자대면부를 제공하여 준다는것 이다. 두번째 우점은 공통대화칸 
을 사용하면 긴 프로그람코드를 서술할 필요가 없게 된다는것이다. 일반적으로 
공통대화칸을 리용하는것은 같은 기능을 여러개의 공통조종체들을 리용하여 실현 
하는것보다 훨씬 간단하므로 프로그람작성 이 보다 효률적으로 된다. 

이 장에서는 처음에 공통조종체의 개념을 설명한다. 다음 가장 중요한 공통조 
종체의 하나인 도구띠에 대하여 설명한다. 또한 마감에 공통대화칸에 대한 설명 
을 한다. 
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공통조종체의 종류 


Windows 2000 이 제공하는 공통조종체들은 다음과 같다. 




동화조종체 

AVI 파일 을 상영 한다. 

확장복합칸조종체 

확장기능을 가지는 복합칸 

날자시간입력조종체 

날자와 시 간을 입 력한다. 

끌기 목록칸 

항목을 끌기할수 있 는 목록칸 

평면홀림 띠 

립체감이 없는 평탄한 흘림띠 

머리부조종체 

렬의 머리부 

주목건조종체 

주목건을 작성 하고 지원한다. 

화상목록 

화상의 목록 

IP 조종체 

인터네트규약 ( IP ) 입 력을 지원한다. 

목록보기 조종체 

아이콘과 표식의 목록 

월사업표조종체 

날자입력에 사용되는 력서 

페 져 조종체 

다른 조종 체를 포함 한 흘러 기가 가능 한 
조종 체 

진행 띠 

처 리의 진행상태를 시각화하여 표시한다. 

특성 표 

속성 대화칸 

리 바조종체 

다른 조종체를 포함한 띠 

고급편집조종체 

고급한 편집칸 

상태 창문 

응용프로그람의 정 보를 표시하는 띠 

표쪽조종체 

표쪽형식의 차림표(조종체의 모양이 서류철 
의 표쪽과 류사하다.) 

도구띠 

도형형식의 차림표 

도구설명쪽지 

튀 여나오기표시 되 는 작은 본문칸. 일 반적으 
로 도구띠단추나 다른 조종체의 설명을 표시 
하는데 사용된다. 

추적 띠 

미끄름조절기형식의 조종체 (사용방법은 흘림 
띠와 갈으나 형태가 음량조절기와 비슷하다.) 

나무구조보기 조종체 

나무구조로 정 보를 표시한다. 

오르내리기 (돌리 개)조종체 

상하방향화살표를 제공한다. 편집칸에 결합 
된 경우는 돌리개조종체 라고도 한다. 
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이 조종체들을 공통조종체 라고 부르는 리유는 여 러 가지 응용프로그람에서 공통적으 
로 사용되는 미리 정의된 조종체들의 모임으로서 제공되고 있기때문이다. 모든 조종체들 
을 취급하는것은 불가능하므로 이 책에서는 가장 중요하고 대표적인 조종체들 몇개만을 
추려서 설명하려고 한다. 


이식과 관련한 요점 : 공통조종체는 Windows 95 및 NT4.0 이후 판에서 사용된다. 


공■조종체를 리용하기 위한 준비와 초기화 


공통조종체 를 리 용하자면 프로그람에 COMMCTRL.H 라는 표준머 리부파일 을 인용 
하여야 한다. 또한 프로그람에 공통조종체서고도 련결하여야 한다. 

Microsoft Visual C ++ 에서는 공통조종체서고의 이름이 COMCTL 32 .LIB 로 되여 있 
다. 이 서 고는 자동적 으로 련결되 지 않으므로 련결프로그람의 추가선택 항목을 설정할 필 
요가 있다. 다른 번역프로그람인 경우에는 해당한 지도서 에서 확인해 야 한다. 

공통조종체 를 사용하는 응용프로그람에 서 는 처 음에 InitCommonControlsEx ( )를 호 
출하여 야 한다. IMtCommonControlsEx () 는 동적 련결서 고에 보관된 공통조종체들을 람 
색 하여 그것 들을 적 재 하고 공통조종체 부분체 계 를 초기 화한다. InitCommonControlsEx( ) 
의 선언은 다음과 갈다. 


BOOL InitCommonControlsEx(LPINITCOMMONCONTROLSEX lpcc ) : 


lpcc 는 적재 혹은 초기화할 조종체를 지정하기 위한 INITCOMMONCONTROL SEX 
구조체 의 지시 자이다. 이 함수는 호출이 성 공하면 0 이 아닌 값을 돌려 주고 실패하면 0 
을 돌려 준다. 

INITCOMMONCONTROLSEX 子포하와 정의는 다음과 같다. 


typedef struct tagINITCOMMONCONTROLSEX { 
DWORD dwSize ； 

DWORD dwICC ； 

} INITCOMMONCONTROLSEX; 


dwSize 에 LPINITCOMMONCONTROLSEX 구조錢 와 크기 를 설정 한다. dwICC 에 는 
적재 할 조종체 혹은 조종체의 모임을 설정 한다. 이것은 다음의 어느 한 값이 여야 한다. 
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ICC_ANIMATE_CLASS 

동화조종체 

ICC_BAR_CLASSES 

상태띠，도구띠 , 도구설명쪽지 및 추적띠 
조종체 

ICC COOL CLASSES 

리 바조종체 

ICC DATE CLASSES 

날자시간입력조종체 

ICC HOTKEY CLASS 

주목건조종체 

ICC INTERNET CLASSES 

인터네트주소조종체 

ICC LISTVIEW CLASSES 

목록보기 및 머리부조종체 

ICC PAGESCROLLER CLASS 

폐 져 조종체 

ICC PROGRESS CLASS 

진행띠 

ICC TAB CLASSES 

표쪽 및 도구설명쪽지조종체 

ICC TREEVIEW CLASSES 

나무구조보기 및 도구설 명쪽지조종체 

ICC UPDOWN CLASSES 

오르내 리 기 조종체 

ICC USEREX CLASSES 

확장복합칸조종체 

ICC_WIN95_CLASSES 

Windows 95 에 서 지 원되 는 공통조종체 


실례 로 아래의 프로그람코드는 도구띠 조종체 를 적재 하고 초기 화한다 . 


INITCOMMONCONTROLSEX cc ； 


cc.dwSize = sizeof (INITCOMMONCONTROLSEX) ； 
cc.dwICC = ICC_B AR_CLASSES ； 

InitCommonControlsEx (&cc) ； 

기본창문이 등록된 다음 InitCommonControlsEx( )를 호출한다 . 

이식과 관련한 요점 : InitCommonControlsEx( ) 는 종래의 InitCommonControls( )를 
대신하여 쓰 인다 . 


공통조종체는 참문이다 


모든 공통조종체 는 새끼 창문이며 CreateWindow( ), CreateWindowsEx( ) 혹은 
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조종체 전용의 API 함수들중 어느 하나를 호출하여 작성된다. (CreateWindowsEx( ) 인 
경 우에 는 확장형 식 을 설정 할수도 있 다. ) 공통조종체 는 창문이 기 때 문에 기 본적 으로 지 금 
까지 프로그람에서 일반적 인 창문을 작성하던것과 같은 방법으로 취급된다. 

많은 공통조종체 는 사용자에 의해 조작되 면 프로그람에 WM_COMMAND 또는 
的乳己八砂 77FF 중의 어느 한 통보문을 보낼수 있다. SendMessage ( ) 타는 API 함수를 사 
용하여 프로그람에서 공통조종체에 통보문을 보낼수도 있다. 선언은 다음과 같다. 

LRESULT SendMessage(HWND hwnd, UINT Msg, 

WPARAM wParam, LPARAM IParam) : 


hwnd 에는 공통조종체의 손잡이 , Msg 에는 조종체에 보내는 통보문, wParm 과 
IParam 에는 통보문과 관련된 추가정보를 설정한다. 이 함수는 조종체로부터 응답이 있 
으면 그것을 돌림값으로 돌려 준다. 


도구띠 의 사용 방 법 


도구띠는 가장 중요한 조종체의 하나이다. 그것은 도구띠가 마우스로 차림표를 선택 
하는 처리를 효률화해 주기때문이다. 도구띠는 형상적인 단추로 되는 아이콘을 차림표의 
항목으로서 제 공하므로 도형적차림 표라고도 한다. 

도구띠가 일반적인 차림표에 대응되는 경우가 많다. 다시말하여 차림표를 선택하는 
조작의 대용으로 되는것이다. 어떤 의미에서 도구띠는 마우스를 사용한 차림표의 가속기 
라고도 한다. 

도구띠를 작성 하기 위해서는 CreateToolbarEx ( ) 합숙•를 사용한다. 선언은 다음과 
갈다. 

HWND CreateToolbarEx (HWND hwnd, DWORD dwStyle, UINT ID, 
int NumBitmaps, HINSTANCE hlnst, 

UINT BmpID, LPCTBUTTON Batons, 
int NumButtons, 

int ButtonWidth, int ButtonHeight, 
int BmpWidth, int BmpHeight, 

UINT Size) : 

hwnd 는 도구띠를 가지는 어미창문의 손잡이 이다. Style 에는 도구띠의 형식을 설정 
한다. 도구띠의 형식에는 WS_CHILD 를 포함시켜야 한다. 또한 WS—BORDER 나 
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WS_VISIBLE 등의 표준적인 형식들을 포함시킬 수도 있다 . 도구띠의 형식에는 몇가지 
추가선택들이 있다 . 다음에 흔히 사용되는 추가선택들을 보여 주었다 . 


추가선택 


TBSTYLE-TOOLTIPS 

도구설명쪽지를 가진다 . 

TBSTYLE WRAPABLE 

긴 도구띠를 여러 행에 걸쳐 표시한다 . 

TBSTYLE FLAT 

평평한 도구띠로 한다 . 

TBSTYLE_TRANSPARENT 

투명한 도구띠로 한다 . 


ID 에 는 도구띠 를 식 별 하는 값을 설 정한다 . BmpID 에 는 도구띠 에 표시 되 는 비 트매 프 
자원을 식 별하는 값을 설정 한다.이 비 트매 프는 도구띠 에 포함되 여 있는 모든 화상들을 
포함한다 . 

NumBitaiap 에 BmpID 에 지정된 비트매프에 포함되는 화상의 수를 설정 한다 . hlnst 
에는 응용프로그람의 실체의 손잡이를 설정한다 . BmpID 에는 자원을 식별하는 값이 아 
니 라 비 트매 프의 손잡이 를 설정 해도 된다 . 이 경우에는 hlnst 에 NULL 을 설정 한다 . 

Buttons 에 정 의 되 는 TBBUTTON 구조체 의 배 렬 에 는 매 개 단추의 정 보를 설 정 한다 . 
NumButtons 에 는 도구띠 안의 단추수를 설정 한다 . ButtonWid 仕 i 와 ButtonHeight 에 는 
단추의 너비와 높이를 설정한다 . BmpWid 仕 i 와 BmpHeight 에는 매개 단추안에 표시되는 
화상의 너비와 높이를 설정한다 . 크기를 표시하는 단위는 화소이다 . Size 에는 
TBBUTTON 구조체의 크기를 설정 한다 . 

CreateToolbarExC ) 는 도구띠창문의 손잡이를 돌려 준다 . 호출이 실패하면 NULL 
을 돌려 준다 . 

매개 단추의 속성을 TBBUTTON 구조체에 설정한다 . TBBUTTON 구조錢와 정의는 
다음과 갈다 . 

typedef struct _TBBUTTON { 
int iBitmap ； 
int idCommand ； 

BYTE fsState ； 

BYTE fsStyle ； 

DWORD dwData ； 
int iString ； 

} TBBUTTON ； 

iBitmap 에는 단추에 표시하는 비트매프의 색인을 설정한다 . 색인이 령인 단추로부 
터 차례로 왼쪽에서 오른쪽에로 표시된다 . 

idCommand 에는 단추를 식별하는 값을 설정한다 . 단추가 눌리울 때마다 
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WM_COMMAND 통보문이 생성되여 그것 이 어미창문에 전송된다 . 이때 idCommand 의 
값이 wParam 의 아래단어 에 보관된 다 . 

fsState 에는 단추의 초기상태를 보관한다 . 이것은 다음의 값(또는 그의 조합)으로 
한다 . 




TBSTATE_CHECKED 

단추를 누른 상태로 한다 . 

TBSTATELELLIPSES 

단추를 모두 표시할수 없는 경우에 생략기호 
를 표시한다 . 

TBSTATE ENABLE 

단추를 누를수 있다 . 

TBSTATE HIDDEN 

단추를 비표시로 하여 사용할수 없게 한다 . 

TBSTATE INDETERMINATE 

단추를 회색표시로 하여 사용할수 없게 한다 . 

TBSTATE—MARKED 

단추에 표식을 불인다 . (늘리워 진 상태와는 
다르다 .) 

TBSTATE—PRESSED 

단추를 누른 상태로 한다 . 

TBSTATE_WRAP 

단추를 모두 표시할수 없는 경우에 여러개의 
행에 표시한다 . 



FsStyle 에는 단추의 형식을 설정한다 . 이것은 다음에 표시한 값들의 조합으로 한다 . 


BTNS—AUTOSIZE 

단추의 크기를 본문에 맞춘다.(낡은 를파일러에 
서는 TBSTYLE AUTOSIZE 를 사용한다 .) 

BTNS_BUTTON 

표준적인 단추 (낡은 콤파 일러에서 는 
TBSTYLE BUTTON 을 사용한다 .) 

BTNS_CHECK 

단추가 눌러울 때 마다 검사상태와 미검사상태를 
반전절 환한다 . (낡은 를파일 러 에 서 는 TBSTYLE_ 
CHECK 를 사용한다 .) 

BTNS_CHECKGROUP 

그룹안에 서 하나밖에 선택할수 없는 단추로 한 
다 . ( 낡 은 틈 파 일 러 에 서 는 TBSTYLE_ 
CHECKGROUP 을 사용한다 . ) 

BTNS.DROPDOWN 

내 리펼침형식의 단추로 한다 . (낡은 콤파일러 에서 
는 TBSTYLE GROUP 를 사용한다 . ) 

BTNS—GROUP 

하나밖에 선택되지 않는 표준적인 단추로 한 
다 . (낡은 름파일 러 에 서 는 TBSTYLE_GROUP 를 
사용한다 .) 

BTNS NOPREFIX 

가속기 로 되 는 앞붙이 를 표시하지 않는다.(낡은 
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를파일러에서는 TBSTYLE _ NOPREFIX 를 사용한 
다.) 

BTNS.SEP 

분리기로 되는 단추로 한다.(이 형식의 경우는 
idCommand 의 값을 령 으로 한다. 낡은 콤파일 러 
에서는 TBSTYLE SEP 를 사용한다. ) 

BTNS—SHOWTEXT 

단추에 본문을 표시 한다. (Windows 2000 에 추가 
된것) 

BTNS.WHOLEDROPDO 

WN 

단추에 내 리 펼침을 의미 하는 아래 방향화살표를 
붙 인 다. (Windows 2000 에 추가된 것 ) 


형식의 이름들을 보면 그 의미를 알수 있을것이다. 그러나 약간한 보충적설명이 필 
요한것들도 있다. BTNS_SEP 는 도구띠의 매개 단추사이의 간격을 비우므로 이것으로 
단추들을 그룹화할수 있다. 

BTNS_DROPDOWN 말 BTNS_WHOLEDROPDOWN 은 내 리펼침차림표를 제 공하는 
단추를 작성 하기 위 해 사용된다. 이 단추들이 눌러 우면 WM_COMMAND 통보문이 아니 
라 TBN _ DROPDOWN 통보문이 생성된다. 이 통보문의 처리에는 제19장에서 설명하는 
차림표의 고급한 기능이 필요된다. 


이식과 관련한 요점 : 도구띠의 형식을 정의 하는 BTNS 로 시작하는 마크로는 종래의 
TBSTYPE 로 시작하는 마크로를 치환한것이다. 실례로 BTNS—SEP 는 TBSTYLE—SEP 
로 불리워왔다. 지금은 두 종류의 마크로가 다 지원되고 있지 만 BTNS 류의 마크로를 사 
용할것을 권고한다. 그러나 낡은 름파일러를 사용하고 있다면 반드시 TBSTYLE 4 r 사 
용해야 하는 경우도 있다. 


TBBUTTON 구조체 의 dwData 에 사용자정 의 자료를 설정 한다. iString 에 는 단추와 
관련된 추가선택문자렬의 색 인을 설정한다. 이 통보문을 사용하지 않는 경 우에 는 령 을 
설 정 한다. 

체 계설정 에서 도구띠는 완전히 자동화된 조종체이며 그것을 조종하는 프로그람코드 
를 서술할 필요는 없다. 그러나 몇가지 통보문을 발송하여 도구띠를 세밀하게 조종할수 
도 있다. 이 통보문들은 SendMessage ( )를 사용하여 도구띠에 전송된다. 도구띠에 보 
내는 주요 통보문들은 다음과 갈다. 



도구띠의 단추를 눌러운 상태 혹은 눌러우지 않 


TB_CHECKBUTTON 은 상태 로 한다. wParam 에 단추를 식 별 하는 값 
을 설정 한다. IParam 에 령 아닌 값을 설정 하면 눌 
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리운 상태로 되며 령을 설정하면 눌러우지 않은 
상태로 된다. 

TB_ENABLEBUTTON 

도구띠의 단추를 유효 혹은 무효로 한다. 
WParam 에 는 단추를 식 별하는 값을 설정한 
다. lParam 에 령 이 아닌 값을 설정하면 유효로 
되며 령을 설정하면 무효로 된다. 

TB_HIDEBUTTON 

도구띠의 단추를 비표시 혹은 표시된 상태로 한 
다. wParam 에는 단추를 식 별하는 값을 설정 한다. 
LParam 에 령 이 아닌 값을 식별하면 비표시로 되 
며 령을 설정하면 표시된다. 


도구띠는 도구띠와 관련된 정보를 프로그람에 알려 주기 위해 통지문을 생성할수 있 
다. 단순한 도구띠에서는 프로그람에서 통지문을 처리할 필요가 없다.(이 통지문들은 
TBN _ 으로 시작되는 이름을 가진다. 통보문들의 의미는 머리부파일 COMMCTRL.H 혹 
은 API 참고서 를 참조할것 ) 

도구설명쪽지의 추가 

도구띠 가운데서 단추우에 Is 정 도 마우스지시 자를 놓아 두면 본문을 표시 하는 작은 
창문이 자동적으로 표시되는데 이 작은 창문을 도구설명 m 지과五 한다. 프로그람의 기능 
에는 무관계하지만 도구띠 에는 도구설명쪽지가 표시되도록 하는것 이 좋다. 

도구띠 에 도구설 명 쪽지 를 표시 하려 면 도구띠 를 작성 할 때 형 식 에 TBSTYLE _ 
TOOLTIPS 를 추가하여야 한다. 이렇게 하면 마우스지시자가 단추우에 약 Is 정도 놓여 
있을 때 도구띠 가 I 次 M _ 八/■公： TifT 통보문을 생 성하게 된다. 

일반적으로 WM_NOTIFY 통보문은 조종체 가 어떤 사건의 발생을 알려 주기 위해 
생 성하는 통보문이 다. 도구설 명 쪽지 의 경 우에 는 도구설명 쪽지 의 본문을 표시할 필요가 
있 다는것 을 알려 주기 위해 생성된다. 이때 lParam 에 는 NMTTDISPINFO 구조제와 지 
시자가 보관되여 있다. 이 구조체의 정의는 다음과 같다. 

Typedef struct tagNMTTDISPINFO { 

NMHDR hdr ； 

LPSTR IpszText ； 
char szText [80] ； 

HINSTANCE hinst ； 

UINT uFlags ； 

LPARAM lParam ； 

} NMTTDISPINFO ； 
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NMTTDISPINF ◦ 의 첫 성 원은 NMHDR 구조제로 되 여 있다. 정의는 다음과 같다. 


typedef struct tagNMHDR 
{ 

HWND hwndFrom ； 

UINT idFrom ； 

UINT code ； 

} NMHDR ； 

도구설 명 쪽지 의 표시 가 요구될 때 는 code 에 TTN _ GETDISPINFO 라는 통지 문이 보 
관되 며 idFrom 에 도구설 명 쪽지 를 표시 할 단추의 ID 가 보관된 다. 다른 조종체 가 
WM_NOTIFY 통보문을 생 성하는 경 우가 있 으며 혹은 도구띠 가 다른 종류의 통지 문을 
생 성하는 경 우도 있 으므로 이 통보문들을 참조하여 어 떤 사건 이 발생 하였 는가를 식 별 해 
야 한다. 


이식과 관련한 요점 : NMTTDISPINFO 구조체는 TOOLTIPTEXT 구조체로 불러우던것 
이다. 낡은 이름의 구조체를 사용 할수도 있지만 새로운 프로그람코드에서 는 
NMTTDISPINFO 를 사 용 해 야 한 다 . TTN_GETDISPINFO 통 보 문 은 
TTN—NEEDTEXT 라고 불러우던것이다. 낡은 이름의 #主문을 사용할수도 있으나 새로 
-& 프로그람코드에서는 TTN_GETDISPINFO 를 사용해야 한다. 

목적하는 도구 설명쪽지를 표시하는데는 세가지 방법 이 있다. 도구 설명쪽지의 본문을 
NMTTDISPINFO 의 szText 에 복사하는 방법 , 본문의 지시 자를 IpszText 에 설정 하는 
방법 및 문자렬 자원의 자원 ID 를 설정하는 방법 이 다. 

문자렬자원을 리용하는 경우에는 문자렬의 ID 를 IpszText 에 설정하고 문자렬자원 
을 포함하는 실체 의 손잡이 를 hinst 에 설정한다. (이것은 일 반적 으로 프로그람실체의 
손잡이 이 다. ) 

이가운데서 제일 간단한 방법은 프로그람안에 있는 문자렬의 지시자를 IpszText 에 
설정하는것이다. 실례로 다음의 프로그람코드는 뒤에서 보여 주는 실례프로그람에서 도 
구설 명 쪽지 의 표시 요구에 응답하는 부분이 다. 

case WM _ NOTIFY ： // 도구설명쪽지의 표시요구에 응답한다. 

TTtext = (LPNMTTDISPINFO) IParam ； 
if(TTtext->hdr.code == TTN_GETDISPINFO) 
switch (TTtext->hdr. idFrom) { 
case IDM_OPEN : TTtext->lpszText = "Open File" : 


// 조종체의 손잡이 
// 조종체의 ID 
// 통지코드 


교육성 프로그람교육멘터 


331 



Windows 2000 프로그람작성법 


break ； 

case IDM_UPPER ： TTtext - >lpszText = "Uppercase”; 
break ； 


case IDM_LOWER: TTtext->lpszText = "Lowercase" ； 
break ； 

case IDM_SAVE ： TTtext->lpszText = ’’Save File”; 
break ； 

case IDM_HELP: TTtext~>lpszText = ” Help”; 
break ； 


} 

break ； 

도구설명쪽지의 본문이 설정되고 Windows 에 조종이 넘어 가면 도구설명쪽지가 자 
동적으로 표시된다. 프로그람에서 이이상의 처리는 필요되지 않는다. 도구설명쪽지의 처 
리는 보통 자동화되여 있으며 간단히 도구띠에 표시할수 있도록 되여 있다. 

NMTTDISPINFO 의 uFlags 통보문은 hdr 의 idFrom 성원에 ID 와 손잡이가운데 
어 느것 이 보관되 여 있는가를 식 별 하기 위 한것 이 다. UFlags 에 TTF _ IDISHWND 7\ 설_정 
되여 있는 경우에는 idFrom 에 도구설명쪽지를 요구하는 조종체의 손잡이가 보관되여 
있 다. 그렇지 않은 경 우는 idFrom 에 조종체 의 ID 가 보관되 여 있 다. 도구띠의 도구설 
명쪽지에서는 idFrom 에 보통 ID 가 보관되여 있으므로 uFlags 의 값을 확인할 필요는 
없다. 

NMTTDISPINFO 의 lParam 통보문에는 사용자가 설정한 임의의 자료가 보관되여 
있 다. 


도구[[ᅵ의 비트매프를 작성 


도구띠를 사용하기전에 화상편집기를 사용하여 매개 단추의 내부에 표시될 화상의 
비트매프를 작성 하여 야 한다. 

도구띠에 설정되는 비트매프는 한개뿐이며 하나의 비트매프안에 모든 단추의 화상을 
보관하여 야 한다. 실례 로 도구띠의 화상이 16 Z 16bit 의 크기 이고 도구띠 에 6 개의 단추 
가 있다면 도구띠 에 설정하는 비트매프의 크기는 96bit(16bit '，6 개)의 너 비와 16bit 의 
높이로 된다. 

이 장에서 작성하는 도구띠의 실례 프로그람에서는 5 개의 화상이 요구된다. 매 개 화 
상의 크기는 16 / 16bit 이 다. 그러 므로 80 X 16bit 의 비 트매 프를 작성 해 야 한다. 그림 
10-1 은 이 장의 실례프로그람에서 사용되는 도구띠의 비트매프를 화상편집기로 작성한 
것 이 다. 이 비 트매 프를 TOOLBAR. BMP 라는 파일 이 름으로 보관해 둔다. 
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그림 10-1. 도구 tJie|| ： S£! 작성 


도구띠 의 실 례프로그 람 


아래 의 프로그람코드는 도구띠 의 응용실 례 를 보여 주는 프로그람이다. 이 프로그람은 
본문파일용의 간단한 상용프로그람이다. 이 프로그람은 다음과 같은 기능을 제공한다. 

• 파일을 읽어 내여 표시한다. 

• 파일의 내용을 대문자로 변환한다. 

• 파일의 내용을 소문자로 변환한다. 

• 파일을 보관한다. 

파일을 읽어 들이면 그 내용이 창문의 의뢰자구역에 표시된다. 파일의 내용을 홀리면 
서 참조할수 있도록 수직흘림띠가 표시된다. 도구띠를 차림표대신에 사용할수 있으며 도 
구설명쪽지도 표시된다. 

파일을 읽 어 들이거 나 보관할 때 파일 이름을 설정하기 위하여 두가지 종류의 공통대 
화칸을 사용한다. 이것들은 표준적인 [파일을 열기] 및 [이름을 불여 보관] 대화칸으로 
서 각각 GetOpenFileNameC ) 및 GetSaveFileNameC ) 타는 API 함수를 호출하여 표시 된 
다. 이 함수들의 사용방법 에 대 해서는 이 장의 뒤부분에서 설명한다. 실례 10-1 에 도구 
띠 프로그람을 표시하였 다. 
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실 례 10-1. Tb 프로그람 

/* 도구설 명 쪽지 기 능을 가진 도구띠 실례 프로그람 

이 프로그람은 파일상용프로그람으로서의 몇 가지 
기능을 제공한다. 

*/ 

#include〈windows. h> 

^include <commctrl. h> 
itinclude <cstring> 
ttinclude <cstdio> 

^include <cctype> 
include，，tb.h，’ 


ttdefine NUMBUTTONS 6 
ttdefine MAXSIZE 25000 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM); 


void InitToolbar( ) ； // 도구띠를 초기화한다. 


void display(int startY, HDC hdc)； // 파일의 내용을 표시한다. 
char szWinName[] = ’’MyWin”; // 창문클라스의 이름 


TBBUTTON tbButtons [NUMBUTTONS] : 


HWND tbwnd； // 도구띠의 손잡이 
FILE *fp; // 파일지시자 

char buf [MAXSIZE] ； // 과일의 내 용을 보관하는 완충기 억 기 
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SIZE size； 

int SBPos = 0； // 흘림띠의 위치 
int X = 5, Y = 32； // 흘러는 크기 
int NumLines = 0； 
int ToolBarActive = 1; 


HWND hwnd； 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

MSG msg; 

WNDCLASSEX wcl； 

HACCEL hAccel； 

INITCOMMONCONTROLSEX cc； 


// 창문믈라스를 정의 한다. 
wcl.cbSize = sizeof (WNDCLASSEX) : 

wcl.hlnstance = hThisInst； // 실체의 손잡이 
wcl.IpszClassName = szWinName; // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc； // 창문함수 
wcl.style = 0； // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ； // 큰 아이콘 
wcl.hlconSm = NULL； // 큰 아이콘의 축소판을 사용한다. 
wcl.hCursor = LoadCursor(NULL, IDC.ARROW) ； // 유표의 형 식 

wcl. IpszMenuName = "ShowFileMenu" ; // 기본차림표 

wcl.cbClsExtra = 0； // 보조기억기령역은 필요 없다. 
wcl. cbWndExtra = 0； 

// 창문의 배경색을 흰색으로 한다. 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ； 


// 창문클라스를 등록한다. 
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if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Using a Toolbar", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결 정 하게 한다 . 
CW_USEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

)； 

// 건반가속기를 적재 한다 . 

hAccel = LoadAccelerators (hThisInst, "ShowFileMenu") : 


// 공통조종체를 초기화한다 . 

cc.dwSize = sizeof (INITCOMMONCONTROLSEX) ; 
cc.dwICC = ICC_BAR_CLASSES; 
InitCommonControlsEx (&cc) : 


InitToolbar( // 도구띠를 초기화한다 . 

// 도구띠를 작성 한다 . 

tbwnd = CreateToolbarEx (hwnd, 

WS_VISIBLE | WS_CHILD | 
WS_BORDER | TBSTYLE_TOOLTIPS, 
IDM_TOOLBAR, 

NUMBUTTONS, 

hThisInst, 

IDTB_BMP, 

tbButtons, 

NUMBUTTONS, 
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16, 16, 16, 16, 
sizeof (TBBUTTON)) ； 


// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) ； 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

if (! Translate Accelerator (hwnd, h Accel, 技 msg)) { 
TranslateMessage(&msg) ； // 건반통보를 변환한다 . 
DispatchMessage(&msg) ； // Windows 2000 에 조종을 넘 긴다 . 

} 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 

PAINTSTRUCT paintstruct ； 
int i, response ； 

SCROLLINFO si ； 

OPENFILENAME fname ； 

char filename[64]; // 파일 이 름 

static char fn[256] ； // 완전경 로명 

char filefilter[] = ” C++\0*.CPP\0C\0*.C\0\0\0"; 

LPNMTTDISPINFO TTtext ； 

RECT rect ； 


switch (message) { 
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case WM.CREATE ： 

// 본문치수를 얻어서 보관한다 . 
hdc = GetDC(hwnd) ； 

GetTextMetrics (hdc, &tm) ； 

ReleaseDC (hwnd, hdc) ； 
break ； 

case WM.NOTIFY ： // 도구설명쪽지의 표시요구에 응답한다 . 
TTtext = (LPNMTTDISPINFO) IParam ； 
if(TTtext->hdr.code == TTN.GETDISPINFO) 
switch (TTtext->hdr. idFrom) { 
case IDM_OPEN: TTtext->lpszText = "Open File”; 
break ； 

case IDM—UPPER: TTtex 卜 〉 IpszText = "Uppercase”; 
break ； 

case IDM_LOWER: TTtext->lpszText = ” Lowercase"; 
break ； 

case IDM_SAVE ： TTtext~>lpszText = ” Save File”; 
break ； 

case IDM.HELP ： TTtext->lpszText = "Help "； 
break ； 

} 

break ； 

case WM.VSCROLL ： 
switch (LOWORD (wParam)) { 
case SB_LINEDOWN: 

SBPos ++； 

if (SBPos>NumLines) SBPos = NumLines ； 
si.cbSize = sizeof (SCROLLINFO) : 
si. f Mask = SIF.POS ； 
si.nPos = SBPos ； 

SetScrollInfo(hwnd, SB.VERT, &si, 1 )； 
InvalidateRect (hwnd, NULL, 1); 
break ； 

case SB.LINEUP ： 

SBPos — ; 

if(SBPos<0) SBPos = 0 ； 
si.cbSize = sizeof (SCROLLINFO) ； 
si. f Mask = SIF.POS ； 
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si.nPos = SBPos ； 

SetScrollInfo(hwnd, SB_VERT, 技 si, 1); 
InvalidateRect (hwnd, NULL, 1); 
break ； 

case SB_PAGEDOWN: 

/* 현재창문의 크기 에 맞추어 

한 페지분의 흘리기를 진행한다 . 이 
GetClientRect (hwnd, &rect) ； 


// 도구띠의 크기분의 보정을 진행한다 . 
if (ToolBarActive) rect. bottom -= 32 ； 

// 흘리기할 행수률 계산한다 . 

SBPos += rect. bottom / 

(tm. tmHeight+tm. tmExternalLeading) ； 


if (SBPos>NumLines) SBPos = NumLines; 
si.cbSize = sizeof (SCROLLINFO) : 
si. f Mask = SIF.POS ； 
si.nPos = SBPos ； 

SetScrollInfo(hwnd, SB_VERT, &si, 1 )； 
InvalidateRect (hwnd, NULL, 1); 
break ； 

case SB_PAGEUP ： 

A 현재창문의 크기 에 맞추어 

한 폐지분의 흘리기를 진행한다 . 히 
GetClientRect (hwnd, &rect) ； 


// 도구띠의 크기분의 보정을 진행한다 . 
if (ToolBarActive) rect. bottom -= 32 ； 


// 흘리기할 행수를 계산한다 . 

SBPos -= rect. bottom / 

(tm. tmHeight+tm. tmExternalLeading); 


if(SBPos<0) SBPos = 0 ； 
si.cbSize = sizeof (SCROLLINFO) : 
si. f Mask = SIF.POS ； 
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si.nPos = SBPos; 

SetScrollInfo(hwnd, SB_VERT, 技 si, 1); 

InvalidateRect (hwnd, NULL, 1); 
break ； 

case SB.THUMBTRACK : 

SBPos = HIWORD(wParam) ； // 현재위치를 얻는다 . 

if(SBPos<0) SBPos = 0 ； 

si.cbSize = sizeof (SCROLLINFO) ； 

si.fMask = SIF.POS ； 

si.nPos = SBPos ； 

SetScrollInfo(hwnd, SB_VERT, 技 si, 1); 

InvalidateRect (hwnd, NULL, 1); 
break ； 

} 

break ； 

case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM_OPEN ： 

// OPENFILENAME 구조체를 초기화한다 . 

memset(&fname, 0, sizeof (OPENFILENAME)); 

fname.lStructSize = sizeof (OPENFILENAME) ； 

fname. hwndOwner = hwnd ； 

fname. IpstrFilter = filefilter ； 

fname. nFilter Index = 1; 

fname. IpstrFile = fn ； 

fname. nMaxFile = sizeof (fn) ； 

fname. IpstrFileTitle = filename ； 

fname. nMaxFileTitle = sizeof (filename) -1 ,* 

fname. Flags = OFN.FILEMUSTEXIST | OFN.HIDEREADONLY ； 

if(!GetOpenFileName(&fname)) // 파일이름을 얻는다 . 
break ； 

if((fp=fopen(fn, "r n ))==NULL) { 

MessageBox(hwnd, fn, "Cannot Open File", MB_OK) ； 
break ； 

} 
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for(i=0 ； Ifeof(fp) 技技 (i < MAXSIZE-1); i++) { 
fread(&buf[i], sizeof (char), 1, fp )； 

} 

buf[i] = ’\0，; 
fclose (fp) ； 


// 행수를 구한다 . 

for (NumLines=0, i=0; buf [i] ； i++) 
if(buf[i] == ’\n’) NumLines++; 

// 흘림띠의 범위로 행수를 설정한다 . 
si.cbSize = sizeof (SCROLLINFO) ； 
si. fMask = SIF.RANGE | SIF.POS ； 
si.nMin = 0; si.nMax = NumLines ； 
si.nPos = 0 ； 

SetScrollInfo(hwnd, SB.VERT, &si, 1 )； 

SBPos = 0 ； 

if(ToolBarActive) Y = 32 ； 
else Y = 0; 

InvalidateRect (hwnd, NULL, 1); 
break ； 

case IDM.UPPER ： // 파일의 내 용을 대문자로 한다 . 
for (i=0 ； buf [i] ； i++) buf [i] = toupper (buf [i]) ； 
InvalidateRect (hwnd, NULL, 1); 
break ； 

case IDM.LOWER ： // 파일의 내 용을 소문자로 한다 . 
for(i=0 ； buf [i] ； i++) buf [i] = tolower(buf [i_ 
InvalidateRect (hwnd, NULL, 1); 
break ； 

case IDM_SAVE: 

// OPENFILENAME 구조체률 초기화한다 . 
memset(&fname, 0, sizeof (OPENFILENAME)) ; 
fname.lStructSize = sizeof (OPENFILENAME) ； 
fname. hwndOwner = hwnd ； 
fname. IpstrFilter = filefilter ； 
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fname. nFilterlndex = 1 ； 

fname. IpstrFile = fn ； 

fname. nMaxFile = sizeof (fn) ； 

fname. IpstrFileTitle = filename ； 

fname. nMaxFileTitle = sizeof (filename) -1 ； 

fname. Flags = OFN.HIDEREADONLY ； 

if(!GetSaveFileName(&fname)) // 파일 이름을 얻는다 . 
break ； 


if ((fp=fopen(fn, ” w"))==NULL) { 

MessageBox(hwnd, fn, "Cannot Open File", MB_OK); 
break ； 

} 

for(i=0 ； buf [i] ； i++) { 
fwrite(&buf [i], sizeof (char), 1, fp) ； 

} 

fclose (fp); 

InvalidateRect (hwnd, NULL, 1); 
break ； 

case IDM.SHOW ： // 도구띠 를 표시 한다 . 

ToolBarActive = 1 ； 

Y = 32 ； // 이전의 도구띠를 복귀한다 . 

ShowWindow (tbwnd, SW.RESTORE) ； 

InvalidateRect (hwnd, NULL, 1); 
break ； 

case IDM.HIDE ： // 도구띠를 비 표시 로 한다 . 

ToolBarActive = 0 ； 

Y = 0 ； 

ShowWindow (tbwnd, SW.HIDE) ； 

InvalidateRect (hwnd, NULL, 1); 
break ； 

case IDM_HELP: 

// [?] 단추를 눌러운 상태로 표시한다 . 

SendMessage(tbwnd, TB.CHECKBUTTON, 

(LPARAM) IDM.HELP, (WPARAM) 1); 
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MessageBox (hwnd, "F2 ： Open\nF3 ： Uppercase \n” 

” F4: Lowercase \nF5 ： Save\n" 

” F6: Show Toolbar \n” 

M F7 ： Hide Toolbar\nCtrl+X ： Exit", 

"File Utilities", MB_OK) ； 

// [?] 단추를 본래의 상태로 복귀한다 . 
SendMessage(tbwnd, TB.CHECKBUTTON, 

(LPARAM) IDM.HELP, (WPARAM) 0); 

break ； 

case IDM_EXIT: 

response = MessageBox(hwnd, "Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQu 仕 Message (0); 
break ； 

} 

break ； 

case WM.PAINT: // 다시 그리 기요구를 처 리 한다 . 
hdc = BeginPaint(hwnd, &paintstruct) ； // 장치 상황을 얻 는다 . 
display(SBPos, hdc); 

EndPaint(hwnd, &paintstruct) ； // 장치 상황을 해제 한다 . 
break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam); 

} 


return 0 ； 

} 

// 도구띠구조체를 초기화한다 . 
void InitToolbar( ) 

{ 
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tbButtons [0]. iBitmap = 0; 

tbButtons [0]. idCommand = IDM_OPEN; 

tbButtons [0].fsState = TBSTATE_ENABLED ； 

tbButtons [0].fsStyle = BTNS_BUTTON; 

tbButtons [0]. dwData = 0L ； 

tbButtons [0]. iString = 0 ； 


tbButtons [1]. iBitmap = 1 ； 

tbButtons [1]. idCommand = IDM_UPPER ； 

tbButtons [ll.fsState = TBSTATE.ENABLED ； 

tbButtons [l].fsStyle = BTNS_BUTTON; 

tbButtons [1]. dwData = 0L; 

tbButtons [1]. iString = 0; 

tbButtons [2]. iBitmap = 2 ； 

tbButtons [2]. idCommand = IDM_LOWER ； 

tbButtons [2]. fsState = TBSTATE.ENABLED ； 

tbButtons [2]. fsStyle = BTNS.BUTTON ； 

tbButtons [2]. dwData = 0L ； 

tbButtons [2]. iString = 0; 

tbButtons [3]. iBitmap = 3; 

tbButtons [3]. idCommand = IDM_SAVE ； 

tbButtons [3]. fsState = TBSTATE_ENABLED ； 

tbButtons [3]. fsStyle = BTNS_BUTTON; 

tbButtons [3]. dwData = 0L; 

tbButtons [3]. iString = 0 ； 

// 단추의 분리기 

tbButtons [4]. iBitmap = 0 ； 

tbBu 竹 ons [4]. idCommand = 0 ； 

tbButtons [4]. fsState = TBSTATE.ENABLED ； 

tbButtons [4]. fsStyle = BTNS.SEP ； 

tbButtons [4]. dwData = 0L ； 

tbButtons [4]. iString = 0 ； 

tbButtons [5]. iBitmap = 4; 
tbButtons [5]. idCommand = IDM_HELP; 


344 


교육성 프로그람교육쎈터 



제 10 장. 공통조종체와 공통대화칸 


比 ) Buttons [5]. fsState = TBSTATE.EN ABLED ； 
tbButtons[5].fsStyle = BTNS_BUTTON; 
tbButtons [5]. dwData = 0L; 
tbButtons [5]. iString = 0; 

} 

// 파일의 내용을 초기화한다 . 

void display (int startline, HDC hdc) 

{ 

register int i, j ； 
int linelim; 
int lines ； 
char line [256]; 

RECT rect ； 
int tempY ； 

GetClientRect(hwnd, &rect); // 창문의 크기를 얻 는다 . 

// 표시할 행수률 계산한다 . 
lines = rect. bottom / 

(tm. tmHeight+tm. tmExternalLeading); 

// 첫행을 찾아 낸다 . 
for(i=0; startline && buf [i] ； i++) 
if (buf [i] == ’\n’) startline — ; 


tempY = Y ； 

// 낡은 내용을 소거한다 . 

PatBlt(hdc, X, Y, rect. right, rect. bottom, PATCOPY); 

// 파일의 내용을 표시한다 . 
for(linelim=lines ； linelim && buf [i] ； i++) { 
for(j=0 ； j<256 && buf[i] && buf [i] != , \n , ； j++, i++) 
line [j] = buf [i]; 

if(!buf[i]) break ； 
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TextOut(hdc, X, Y, line, j )； 

// 다음 행으로 이동한다 . 

Y = Y + tm. tmHeight + tm. tmExternalLeading ； 
linelim — ； 

} 

Y = tempY ； 

} 

이 프로그람은 다음의 자원파일을 필요로 한다. 

ttinclude < windows. h> 
include " 比 ). h” 


IDTB.BMP BITMAP toolbar.bmp 


ShowFileMenu MENU 

{ 


POPUP ” &File n 


MENUITEM ” &Open\tF2", IDM.OPEN 
MENUITEM n &Uppercase\tF3 H , IDM.UPPER 
MENUITEM n &Lowercase\tF4 M , IDM.LOWER 
MENUITEM ” &Save\tF5”, IDM.SAVE 
MENUITEM ”E&xit\tCtrl+X", IDM.EXIT 


} 

POPUP M &Options M 

{ 


MENUITEM n &Show Toolbar \tF6", IDM.SHOW 
MENUITEM ” &Hide Toolbar \tF7”, IDM.HIDE 


MENUITEM M &Help M , IDM.HELP 

} 


ShowFileMenu ACCELERATORS 

{ 

VK_F2, IDM.OPEN, VIRTKEY 
VK_F3, IDM.UPPER, VIRTKEY 
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VK_F4, IDM.LOWER, VIRTKEY 
VK_F5, IDM_SAVE, VIRTKEY 
VK_F6, IDM—SHOW, VIRTKEY 
VK_F7, IDM—HIDE, VIRTKEY 
VK_F1, IDM_HELP, VIRTKEY 
^X ?, , IDM—EXIT 

} 

머 리 부파일 TB.H 의 내 용은 다음과 같다. 


ttdefine IDM_OPEN 100 

#define IDM_UPPER 101 

ttdefine IDM_LOWER 102 

Mefine IDM_SHOW 103 

ttdefine IDM.HIDE 104 

#define IDM_SAVE 105 

ttdefine IDM_HELP 106 

Mefine IDM.EXIT 107 

#define IDM_TOOLBAR 200 

Mefine IDTB—BMP 300 


프로그람의 실행결과는 그림 10-2 와 같다. 



그림 10-2. 도구 HI 프로그람의 실행결과 
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도구띠프로그람의 상세 

도구 띠프로그람은 매우 간단한 파일조작기능을 제공한다. 차림표 또는 도구 띠로부터 
[ Open ] 이 선택된 경우는 파일 이 열리고 그 내용이 건선 에 읽 어 들여 진다. buf 의 크기 
는 적당히 설정한것이므로 필요에 따라 변경시킬수 있다. 

WM_PAINT 통보문을 접 수할 때 마다 display ( ) 에 의 해 완충기억 기 ( buf ) 의 내 용이 
창문에 표시 된 다. display ( ) 프로그람코드는 제 8 장에 서 본문을 창문에 표시 할 때 리 용된 
것과 동일한 수법 을 쓰고 있으므로 내 용을 쉽 게 리 해할수 있을것 이 다. 

[ Uppercase ] 가 선택된 경우는 완충기 억기의 내용이 대문자로 변환된다. 
[ Lowercase ] 가 선택된 경우는 완충기억기의 내용이 소문자로 변환된다. [ Save ] 가 선택 
된 경우는 완충기억기의 내용이 파일에 보관된다. 이 러한 조작들은 차림표와 도구 띠가운 
데서 임의의것을 리용하여 진행한다. 

도구띠의 정보는 배렬 tbButtons 에 보관된다. 이 배럴은 InitToolBarC ) 안에서 초 
기화된다. 구조체배렬의 다섯번째 요소는 단지 단추의 분리기로 되여 있다는 점에 주의 
해야 한다. WinMain ( )에서는 InitCommonControlsEx ( ) 함수가 호출되고 있다. 그 다 
음 도구띠 가 작성 되 여 그 손잡이 가 tbwnd 에 보관된 다. 

도구띠의 매개 단추는 기본차림표의 차림표항목에 대응되여 있다. 분리기를 제외한 
매 단추의 ID 는 대응되는 차림표의 ID 와 같다. 단추가 눌러우면 마치도 차림표가 선택 
된것 처 럼 그것의 ID 가 WM_COMMAND 통보문과 함께 전송된다. 사실 같은 case 문에 
서 도구띠와 차림표의 두가지 선택을 처 리하고 있다. 

도구띠 도 창문이 므로 그것 을 ShowWindowC ) 함수를 사용하여 표시 하거 나 비 표시 
로 할수 있다. 창문(여기서는 도구띠)을 비표시로 하려는 경우는 [Op 仕 on ] 차림표에서 
[Hide Tmlbar ] 를 선택 한다. 다시 도구띠 를 표시 하려 면 [Show Toolbar ] 를 선택 한다. 

도구띠는 기본창문의 의뢰 자구역의 일부에 표시 한것 이므로 그것 이 불필요한 경우에 
는 언제든지 소거할수 있게 해야 한다. 이것은 실례프로그람에서 볼수 있는바와 같이 아 
주 간단히 실현할수 있다. 

IDM_HELP 의 case 문의 내용을 보면 차림표 또는 도구띠로부터 [ Help ] 가 선택된 
경 우 TB_CHECKEDBUTTON 통보문을 보냄 으로서 [?] 단추를 눌러 운 상태 로 한다. 도 
움말통보칸이 닫기면 단추를 본래의 상태로 되돌린다. 

그러므로 도움말통보칸이 표시 되 여 있는동안에 는 [?] 단추가 눌러 운 상태 대 로 있 다. 
이것은 필요에 따라 프로그람에서 수동적으로 도구띠를 조종하는 하나의 실례로 된다. 

창문에 표시 된 파일의 내 용은 수직 홀림 띠 를 사용하여 흘리 기할수 있 다. 흘림 띠 의 사 
용방법에 대해서는 제 6 장에서 설명하였다. Display ( ) 함수는 파일의 내용을 표시한다. 
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창문의 현재의 크기에 맞게 본문을 출력할수 있게 되여 있다.(이것은 화면에 정보를 출 
력 하고 그것 을 Windows 에 자르기시 키 는것 보다도 효률적 인 방법 이 다. ) 

창문의 현재크기는 제 8장에서 설명한 GetClientRect () 를 사용하여 엄는다. 이 함수 
는 RECT 구조체 에 현재창문크기를 돌려 준다. 여기 에서는 표시할 파일의 내용을 어 느 
정도로 하면 좋겠는가를 계산하는데 이 크기를 사용하고 있다. 

공를대화칸의 기초 


도구띠프로그람에 서는 읽 거 나 쓸 파일 의 이 름을 각각 GetOpenFileName ( ) 및 
GetSaveFileNameC ) 라는 함수를 사용하여 얻고 있다. 이 함수들은 파일이름을 얻기 위 
한 [파일을 열기] 및 [이름을 불여 보관] 이 라고 부르는 대화칸을 표시하는 함수들이다. 

[파일을 열기] 및 [이 름을 불여 보관]은 공통대 화칸이라고 부르는 미 리 갖추어 진 
대화칸의 일종이다. 공통대화칸은 체계에서 정의된 대화칸이며 파일이름을 엄거나 서체 
의 선택이나 색설정 등 다양한 프로그람에서 일반적형식의 입력을 진행하기 위하여 사용 
할수 있다. 


|다시 한보 전진| 


WM_SIZE 통보문을 보내기 

도구띠프로그람으로 실험을 해 보자. 프로그람을 실행하고 창문의 수평방향 
의 크기를 늘여 보면 도구띠의 크기가 자동적으로 변하지 않는다는것을 알게 될 
것이다. 그 리유는 도구띠가 프로그람의 기본창문의 새끼창문이기때문이다. 그러 
므로 도구띠가 크기변경통보문을 자동적으로 엄게 되는것이 아니다. 

만일 새끼창문(여기서는 도구띠)이 크기변경통보문을 받게 하고싶다면 통보 
문을 보내는 처리를 하여야 한다. 례를 들어 도구띠프로그람에서 크기변경을 실 
현하려 면 WindowFunc ( ) 에 다음의 case 문을 추가한다. 

Case WM—SIZE: 

// 크기변경통보문을 도구띠 에 보낸다 . 

SendMessage (tbwnd, WM_SIZE, wParam, IParam); 

Break ； 
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이 프로그람코드를 추가하면 기본창문을 넓힐 때 그에 응하여 도구띠의 크기 
가 자동적으로 변경된다. 

일 반적 으로 기 본창문의 크기 가 변경 된 때 창문은 竹^ S/ZE 통보문을 받는다. 
창문의 새로운 너비는 LOWORD(lParam) 에 보관된다. 창문의 새로운 높이는 
HIWORD(lParam) 에 보관된다. WParam 에는 아래의 어느 한 값이 보관되여 있다. 


| WParam 의 미 | 

SIZE-RESTORED 

창문이 본래의 크기로 복귀되였다. 

SIZE MAXIMIZED 

창문이 최대화되였다. 

SIZE_MINIMIZED 

창문이 최소화되였다. 

SIZE MAXHIDE 

다른 창문이 최대화되였다. 

SIZE—MAXSHOW 

다른 창문이 본래의 크기로 복귀되였다. 


일반적인 규칙으로서 프로그람에 새끼창문이 포함되여 있는 경우는 기본창문 
의 창문함수로부터 새끼창문에 적절한 크기변경통보문을 보낼 필요가 있다. 


공통대 화칸은 창문을 작성 해 야 하는 공통조종체와는 달리 API 함수를 호출하기만 하 
면 표시된다. Windows 2000 에 서 지 원되 는 공통대 화칸의 종류는 다음과 같다. 


함 수 표시되는 대화칸 

ChooseColor( ) 

[색 설정]대 화칸을 표시한다. 사용자는 색 선택 이 나 전용 

색의 작성을 진행한다. 

ChooseFont( ) 

[서체]대화칸을 표시한다. 사용자는 서체를 선택할수 

있 다. 

FindTextC ) 

본문검색을 위한 [검색]대화칸을 표시한다. 

GetOpenFileName ( ) 

[파일을 열기]대화칸을 표시한다. 사용자는 읽거 나 쓰 

려는 파일을 선택할수 있다. 

GetSaveFileName ( ) 

[이 름을 붙여 보관] 대 화칸을 표시한다. 사용자는 정 보 

를 보관할 파일을 선택할수 있다. 

PageSetupDlg( ) 

인쇄폐 지의 서식을 설정 하기 위한 [폐 지 설정] 대 화칸을 

표시 한다. 

PrintDlg( ) 

파일을 인쇄하기 위한 [인쇄]대화칸을 표시한다. 
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PrintDlgEx ( ) 

Windows 2000 판의 PrintDlg ( ) 

ReplaceText ( ) 

본문치환을 위 한 [치환]대화칸을 표시한다. 


이 장의 나머지 부분에서는 [파일을 열기] 및 [이름을 불여 보관]의 두가지 대화칸 
의 사용방법 을 설 명한다. 제 17 장에 서 는 [인쇄 ] 공통대 화칸의 사용방법 을 설 명한다. 이 
공통대화칸들의 사용방법을 습득하면 자체로 다른 공통대화칸들의 사용방법도 쉽게 파악 
할수 있다. 

공통대화칸을 통해 진행하는 형식의 입 력을 자체 로 작성한 대화칸에서 해서는 안된 
다는 리유는 없으나 그렇게 하지 않는것이 일반적 이다. 공통대화칸을 리용할수 있는 상 
황이라면 그것 을 리용해 야 한다. 

공통대화칸을 사용하는 리유는 그것을 프로그람의 사용자가 기대하고 있기때문이다. 
공통대 화칸은 째 복잡한 프로그람작성 이 필 요되 는 입 력 처 리 에 매 우 간단한 해 결 책 을 제 
공해 준다. 

GetOpenFileName( ) 과 GetSaveFileName( ) 

[ Open ] 대화칸은 읽거나 쓸 파일의 이름을 설정하는데 사용된다. 사용자는 파일이 
틈을 입력할수도 있고 목록에서 선택할수도 있다. 혹은 등록부를 변경하는것도 가능하다. 
[과일을 열기]대화칸은 GetOpenFileNameC ) 함수의 호출에 의해서 표시된다. 이 함수 
가 호출되면 다음과 갈은 대화칸이 표시된다. 
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[Save As ] 대화칸은 출력이 써넣어 질 파일을 설정하는데 사용된다. 다음에 [Save 
As ] 대화칸을 보여 주었다. 



GetOpenFileNameC ) 및 GetSaveFileName ( ) 꺅 선언은 다음과 같다. 

BOOL GetOpenFileName (LPOPENFILENAME lpBuf ) : 

BOOL GetSaveFileName (LPOPENFILENAME lpBuf ) : 


LpBuf 는 OPENFILENAME 구조체 의 지시 자이 다. 이 함수들은 사용자에 의 해 유효한 
파일이름이 지정된 경우에 령이 아닌 값을 돌려 주며 그밖의 경우에는 령을 돌려 준다. 

LpBuf 가 가리 키는 OPENFILENAME 구조체는 함수를 호출하기 전에 초기화하여야 
한다. 돌림값으로서 사용자에 의해 지정된 파일이름과 그밖에 몇가지 정보가 
OPENFILENAME 구조체에 보관된다. 아래에 OPENFILENAME 구조제와 정의를 준다. 


typedef struct tagOFN 
{ 

DWORD IStructSize ； 
HWND hwndOwner ； 
HINSTANCE hlnstance ； 
LPCSTR IpstrFilter ； 
LPSTR IpstrCustomFilter ； 
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DWORD nMaxCustFilter ； 

DWORD nFilterlndex ； 

LPSTR IpstrFile; 

DWORD nMaxFile ； 

LPSTR IpstrFileTitle ； 

DWORD nMaxFileTitle ； 

LPCSTR lpstrlnitialDir ； 

LPCSTR IpstrTitle ； 

DWORD Flags ； 

WORD nFileOffset ； 

WORD nFileExtension; 

LPCSTR IpstrDefExt ； 

LPARAM lCustData ； 

LPOFNHOOKPROC lpfnHook ； 

LPCSTR lpTemplateName ； 
void *pvReserved;// Windows 2000 에서만 사용 
DWORD dwReserved ； // Windows 2000 에서만 사용 
DWORD FlagsEx；// Windows 2000 에서만 사용 
} OPENFILENAME ； 


◦PENFILENAME 구조체의 매 성 원들을 설명 해 보자. 

LStructSize 에 OPENFILENAME 구조체 의 크기 를 설정 한다. HwndOwner 에 대 화 
칸의 어 미창문의 손잡이 를 설 정한다. Flags 에 OFN.ENABLETEMPLATE 혹은 
OFN_ENABLETEMPLATEHANDLE 을 설정한 경우는 hlnstance 에 대화칸본보기의 
손잡이 를 설정 한다. 그렇 지 않은 경 우 hlnstance 는 사용되 지 않는다. 

LpstrFilter 에 파일 이 름의 선별기 를 정 의하는 문자렬쌍을 설정한다. 문자렬쌍이 란 
[설명1파 [마스크] 이 다. 실례 로 “C Files ””*. C ” 이 라면 C Files 가 설명 이 고 마스크는 *.C 
이다. 목록의 끝에는 종단을 의미하는 령문자를 두개 배치한다. 사용자가 선택할수 있는 
선별기의 이름은 내리펼침형식의 목록에 표시된다. 

LpstrFilter 에 NULL 을 설정 한 경우는 파일 이름의 선별기 가 사용되지 않는다. 

IpstrCustomFilter 에는 사용자에 의해 입력된 선별기를 보관하는 배럴의 지시자를 
설정한다. 이 배렬에는 앞에서 보여 준 서식을 사용하여 설명과 파일선별기가 보관되게 
된다. 그러나 사용자가 파일이름을 선택한후에는 새로운 선별기가 배렬에 복사된다. 

IpstrCustomFilter 에 NULL 을 설정한 경우는 이 성 원자체 가 무시된다. 배 럴의 길 
이 는 40문자(혹은 그이 상) 이 여 야 한다. 

nMaxCustFilter 에는 IpstrCustomFilter 에서 가러 키는 배 렬의 크기 를 설정 한다. 이 
값은 IpstrCustomFilter 가 NULL 인 경 우에 만 필 요된 다. 
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nFilterlndex 에 IpstrFilter 에서 가리키는 문자렬쌍가운데서 대화칸이 표시되였을 
때 초기의 파일선별기 혹은 설명으로 되는 문자렬을 설정한다. 1 이라면 맨 앞의 쌍을 가 
리키는것으로 되며 두번째 쌍이라면 2,••- 등으로 된다. 이 값은 IpstrFilter 가 NULL 인 
경 우에 는 무시 된다. nFilterlndex 가 령 인 경 우에 는 IpstrCustomFilter 에 서 가리 키 는 문 
자렬이 사용된다. 

IpstrFile 에는 사용자에 의 해 선택된 완전한 파일 이름, 경 로이름 및 구동기이름을 보 
관하기 위 한 문자렬을 설정 한다. 이 배 렬에는 파일 이름의 편집칸을 초기화하는데 사용 
되는 초기의 파일이름을 설정하든가 그렇지 않으면 빈 문자렬을 설정해 둔다. 

nMaxFile 에 lps 切 "File 에서 가리키는 배럴의 크기를 설정한다. 이 배렬에는 최대길 
이의 파일 이름을 보관할수 있도록 적 어도 256 byte 이상의 길이로 해 야 한다. 

IpstrFileTitle 에는 사용자에 의해 선택된 파일의 파일이름(경로나 구동기의 정보를 
제외한것)을 보관하기 위한 배럴을 설정한다. 이 파일이름이 불필요한 경우에는 이 성원 
을 NULL 로 한다. 

nMaxFileTi 仕 e 에는 IpstrFileTitle 에서 가리키는 배 럴의 크기를 설정 한다. 

lpstrlnitialDir 에는 대 화칸이 표시될 때 제 일 처음 사용되는 등록부를 가리키는 문 
자렬 을 설정한다. 그러 나 IpstrFile 에 경 로이 름이 부여 된 경 우는 그 경 로이 름이 사용되 
며 lpstrlnitialDir 는 무시된다. lpstrlni 仕 lalDir 가 NULL 인 경우는 현재 등록부가 사용된다. 

지정된 선별기에 일치되는 파일이 현재등록부에 존재하지 않는 경우는 직전의 등록 
부가 사용된다. (직전의 등록부는 사용자가 파일을 선택 할 때 마다 LastVisited 라는 체 계 
자료기지기 입항목에 보관된다.) 직전의 등록부가 없는 경우는 가능하다면 사용자의 
Personal 등록부가 사용되며 그렇지 않은 경우는 탁상면등록부가 표시된다. 

IpstrTitle 에 는 대 화칸의 제 목으로 사용되 는 문자렬 의 지 시 자를 설 정 한다. 
LpstrTitle 이 NULL 인 경우는 체 계설정의 제목이 사용된다. GetOpenFileNameC ) 의 체 
계설정의 제목은 [Open File ] 이 며 GetSaveFileName ( ) 의 체 계설정제 목은 [Save As ] 
이 다. 

Flag 성 원 은 대 화 칸 에 여 러 가 지 설 정 들 을 진 행 하 는 데 사 용 된 다 . 
GetOpenFileNameC ) 과 GetSaveFileName ( ) 은 모두 많은 추가선택항목들을 지원하고 
있다. 흔히 사용되는 추가선택항목들을 아래에 보여 주었다 .( 필요에 따라 두개 이상의 
기 발을 OR 연산으로 조합할수도 있 다. ) 


◦ FN_ENABLEHOOK 

lpfnHook 에서 가리키는 함수를 사 
용하도록 허가한다. 

◦ FN—ENABLETEMPLATE 

대화칸본보기를 사용하는것을 허가 
한다. 이 경 우는 hlnstance 에 
lpTemplate 에 서 가러키 는 대 화칸을 
포함한 모둘의 실체손잡이 를 설정한 
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다. 

OFN _ 

ENABLETEMPLATEHANDLE 

대화칸본보기를 사용하는것을 허가 
한다. 이 경 우는 hlnstance 에 대 화칸 
을 포함하는 기 억기 령역의 손잡이를 
설정 한다. 

◦ FN-FILEMUSTEXIST 

사용자는 기 존의 파일 만을 선택할수 
있 다. 

◦ FN_HIDEREADONLY 

읽 기 쓰기 전용의 검 사칸을 표시하지 
않는다. 

OFN—NOCHANGEDIR 

사용자는 현재 의 등록부를 변경할수 
없다. 

OFN.OVERWRITEPROMPT 

사용자가 기 존의 파일 을 선택한 경 
우에 검사를 위 한 창문을 표시한다. 

◦ FN-PATHMUSTEXIST 

사용자는 기 존의 경 로만을 선택할수 
있 다. 


nFileOffset 성 원에 는 IpstrFile 에 서 가리 키 는 배 럴 에 돌려 지 는 문자렬 안에 들어 있 
는 파일이름의 제 일 첫 색 인을 설정한다. (이 배럴은 파일이름만이 아니 라 구동기와 경로 
정보도 포함하고 있다.) 

nFileExtension 에는 IpstrFile 에서 가리키는 배렬에 돌려 지는 문자렬안에 있는 파 
일의 확장자의 색 인을 설정한다. 

IpstrDefExt 에는 사용자에 의해 입력된 파일이름에 확장자가 포함되여 있지 않을 
때 사용되는 체계설정의 확장자를 설정한다. (이 확장자는 선두에 점을 붙이지 않고 설정 
한다.) 

lCustData 에 는 lpfnHook 에 서 가리 키 는 함수에 보내 는 자료를 설정한다. 

lpfnHook 에 는 대 화칸에 보내 는 통보문을 먼저 받는 함수의 지 시 자를 설정한다. 
lCustData 는 Flags 의 값에 OFN+ENABLEHOOK 가 포함되 여 있는 경 우에 만 사용된다. 

lpTemplateName 에는 대화칸본보기의 이름을 설정한다. hlnstance 에는 대화칸의 
자원을 포함한 모둘의 손잡이를 설정하여야 한다. 

lpTemplateName 은 Flags 에 OFN_ENABLETEMPLATE 가 포함되여 있지 않은 
경우에는 무시된다. 

마지막 세개의 성원들인 pvReserved,dwReserved 및 FlagsEx 는 Windows 2000 
에 새롭게 추가된것들로서 다른 판본의 Windows 에서는 사용되지 않는다. 현재 
ExtFlags 에서 지원되는 추가기발은 OFN _ EX_NOPLACESBAR 뿐이다. 이것은 탐색기 
( Explorer ) 형식의 위 치띠 (왼쪽에 표시되는 띠)를 비표시로 하기 위한것 이다. 

도구띠프로그람에서 OPENFILENAME 구조체 ( fname ) 가 어떻게 초기화되고 있는가 
에 주목해야 한다. 사용되지 않는 많은 성원들을 NULL 로 설정해야 하므로 맨 처음 
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memset ( )를 사용하여 구조체의 모든 성원들을 령으로 설정하고 있다. 이것은 일반적인 
기 법으로서 이 프로그람에서도 사용되고 있다. 

fname 의 모든 성 원들을 령 으로 설정한 다음 필요한 성 원만을 설정한다. 배 렬 
filefilter 를 초기화하는 방법에 주목해 야 한다. IpstrFilter 에서 가리키는 배럴에 문자렬 
쌍을 설정하는 방법 이 리해될것 이다. 

파일이름을 얻은 다음 그것을 사용하여 파일을 연다. 이 경우에는 IpstrFile 에서 
가리 키 는 fn 에 보관되 여 있는 구동기 이 름, 경 로이 름 및 파일 이 름전체 가 사용된다. 파일 
을 현재등록부만으로 제한하려고 한다면 IpstrFileTitle 에서 가리키는 filename 의 내용 
만을 사용할수도 있다. 

여 러 가 지 추 가 선 택 항 목 들 을 지 정 하 여 자 체 로 GetOpenFileName ( ) 및 
GetSaveFileName ( ) 의 기 능 을 구 체 적 으 로 조 사 해 보 는 것 이 좋 다 . 례 하 면 
IpstrCustomFilter 를 사용해 볼수 있다. 이 두개의 미 리 갖추어 진 대화칸은 거의 모든 
응용프로그람에 서 쓰이 는 중요한 대 화칸들이다. 


Windows 2000 프로그람에서 과일들 읽거 나 쓰는 방법 


이 장을 끝내기 에 앞서 Windows 2000 프로그람에서 파일을 읽거 나 쓰는 방법 에 대 
해 간단히 설명해 둘 필요가 있다. 

Windows 2000 프로그람에서 파일을 읽거 나 쓰는것은 매우 간단하다. 왜 냐하면 
Windows 2000 프로그람을 작성할수 있는 모든 C / C ++ 번역프로그람들이 Windows 2000 
에서 사용할수 있는 수많은 함수와 클라스들을 제공하고 있기때문이다. 

이 러 한것들가운데 는 open ( )， close ( )， fopen ( ), istream 및 ostream 등이 있다. 
아무런 우려도 없이 이 함수나 클라스들을 여느 때처럼 사용하여 파일의 입출력을 실현 
할수 있다. 이 려한 함수들은 도구띠프로그람에서도 사용되고 있다. 

그러나 만일 필요하다면 CreateFile ( ), ReadFileC ) 및 WriteFileC ) 등의 Win 32 
에서 정의된 API 함수들을 사용할수도 있다. 
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오르내리기 조종체， 
추적出 및 진행띠 


이 장에서는 Windows 2000 의 공통조종제들인 오르내리기조종체 
( Up-down control ) , 추회公 ’/(Track bar ) 및 2/평’公7 (Progress bar ) 에 대 
해 소개한다. 이 조종체들은 현존프로그람을 Windows 2000 에 이식할 때 
매우 중요한것으로 된다. 왜냐하면 이 조종체들이 새로운 응용프로그람들 
에서 많이 사용되고 있으며 시각적 인 효과가 크고 프로그람의 조작성을 확 
장할수 있기때문이다. 

이 장은 이러한 조종체들에 대한 초보적지식을 설명하는것으로부터 시 
작한다. 다음 제 6 장에서 작성한 내 려세기프로그람의 확장판의 작성을 통 
하여 조종체들의 사용방법을 보여 주었다. 단순히 몇개의 조종체 를 추가 
한것 에 의해 응용프로그람의 사용자대 면부가 많이 개 선되 는것 을 보게 
될것이다. 
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오르내리기조종체의 사용방법 


오르내리기조종제는 홀림띠를 간단히 한것이다. 이 조종체에는 흘림띠의 량쪽 끝의 
화살표들만이 있으며 이 화살표들사이에는 띠가 없다. 어떤 Windows 응용프로그람을 
사용할 때 본적이 있을수도 있겠지만 흘림띠들가운데는 너무 작아서 띠의 조작이 불가능 
한것도 있다. 이러한 경우에 대처하기 위해 오르내리기조종체가 고안되였다. 

오르내 리기조종체에는 두가지 사용방법 이 있다. 하나는 독립적 인 홀림띠와 류사한 
사용방법이 다. 다른 하나의 사용법 은 련동조종체 로 되는 다른 조종체 와 함께 사용하는것 
이 다. 일 반적 으로 편집칸을 련동조종제로 한다. 

편집 칸과 오르내 리 기조종체 와의 조합을 돌근/계조종//八 Spin control ) 또는 돌리개 
( Spinner ) 라고 한다. 오르내 리 기 조종체 의 두가지 사용방법 을 아래 에 보여 주었다.(왼쪽 
에 있는것이 돌리개조종체이다.) 



돌리 개 조종체 를 사용할 때 는 조종체 에 대 한 대 부분의 조종을 Windows 2000 이 자동 
화하여 준다. 그러므로 응용프로그람에 간단히 돌리개조종체를 추가할수 있다. 단독의 
오르내 리 기조종체 와 돌리개 조종체의 작성 과 조종방법 에 대 해서는 다음에 설명 한다. 

오르내리기조종체의 작성 

오르내 리기 조종체를 작성 하려면 CreateUpDownControl () 함수를 사용해 야 한다. 선 
언은 다음과 갈다. 


HWND CreateUpDownControl (DWORD Style , int X,int Y , 
int Width , int Height , HWND hParent , 
int ID , HINSTANCE hlnst , 

HWND hBuddy , int Max , int Min , int StartPos ) : 
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Style 에 오르내 리 기조종체의 형식을 설정한다. 이 파라메터 에는 표준적 인 형식 인 
WS _ CHILD , WS_VISIBLE 및 WS_BORDER 를 포함시 켜 야 한다. 

이 형식들외에 표 11-1 에 보여 준 형식을 한개이상 설정할수 있다. 


표 11-1. 오르내리기조종체의 형식 


UDS—ALIGNLEFT 

오르내 리 기조종체 를 련동조종체 의 왼쪽에 표시한다. 

UDS—ALIGNRIGHT 

오르내 리 기조종체 를 련동조종체 의 오른쪽에 표시 
한다. 

UDS_ARROWKEYS 

방향건을 유효로 한다.(방향건으로 조종체 를 조작 
할수 있다.) 

TBS—AUTOBUDDY 

다음의 Z 차례에 있는 조종체를 련동조종체로 한다. 

UDS—HORZ 

오르내 리 기 조종체 를 수평 으로 표시한다.(체 계설정 
으로는 수직으로 표시된다.) 

UDS_HOTTRACK 

마우스가 우에 놓였을 때 오르내리기조종체의 화살 
표를 강조표시 시 킨다. (Windows 2000 및 Windows 
98 에 서 만) 

UDS_NOTHOUSANDS 

큰 값이 라고 해 도 련동조종체 에 반점 을 표시하지 
않는다. (돌리 개 조종체 의 경 우에 만) 

UDS—SETBUDDYINT 

조종체의 값이 변화되였을 때 자동적으로 련동조종 
체 의 표시 를 갱 신한다. 이 에 의해 오르내 리 기 조종체 
의 현재의 값이 련동조종체에 표시된다. 

UDS—WRAP 

오르내 리기조종체 에 표시되는 값이 긴 경우는 잘리 
여 표시된다. 


오르내 리 기 조종체 의 위 치 를 X 와 Y 에 설정 한다. 조종체 의 너 비 와 높이 를 Width 와 
Height 에 설정 한다. 

hParent 에 는 어 미 창문의 손잡이 를 설정 한다. ID 에 는 오르내 리 기 조종체 를 식 별 하는 
값을 설정 한다. hlnst 에 응용프로그람의 실체손잡이 를 설정 한다. 련동조종체의 손잡이는 
hBuddy 에 설 정 한다. 련동조종체 를 사용하지 않는 경 우는 이 파라메 터 에 NULL 을 설 
정하여야 한다. 

조종체 에 서 설정 하는 값의 범 위 를 Max 와 Min 에 설정 한다. Max 가 Min 보다 작은 
경우는 조종체의 동작이 거꾸로 된다. 조종체의 초기값(지정된 범위의 값이 여야 한다.) 
을 StartPos 에 설 정 한다. 

오르내 리 기조종체는 화살부분이 눌리 웠을 때 증가 또는 감소되는 내부적 인 계수기를 가 
지고 있다. 내부적인 계수기의 값은 항상 조종체가 작성되였을 때 지정된 범위내에 있다. 

이 함수는 조종체의 손잡이를 돌려 준다. 호출이 실패하면 NULL 이 돌려 전다. 
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오르내리기 조종체로부 a 통보문을 받아들이기 

오르내리기조종체의 화살부분이 눌러우면 조종체가 수직형 (체계설정형식)인가 수평 
형 인가에 따라 조종체 로부터 어 미 창문에 WM_VSCROLL 또는 WML / ZSO ? 幻 LL 통보문이 
발송된다. 이때의 IParam 에는 오르내 리기조종체의 손잡이가 보관되 여 있다. 

WM_VSCROLL 통보문과 WM_HSCROLL 통보문을 생성 하는 조종체 가 한개 만이 아 
닌 경우도 있으므로 이 손잡이의 값을 검사하여 그것 이 오르내 리기조종체 인가를 검사할 
필요가 있다. 

오르내 리기조종체의 새로운 값은 HIWORD ( wParam ) 에 보관되여 있다. 

오르내리기 조종제에 롬보문들 보내기 

오르내 리 기 조종체 는 여 러 가지 통보문에 응답한다. 기 본적 인 통보문들을 표 11-2 에 주 
었 다. 실례 로 조종체 의 값을 엄 는 경 우에 는 L 取雄公 S 통보문을 보낸다. 이 통보문 
에 응답하여 조종체 의 현재값이 돌려 진다. 오르내 리 기 조종체 의 값을 설정하는 경 우에 는 
UDM_SETPOS 통보문을 보낸다. 오르내리기 조종체에 통보문을 보내려면 
SendMessage ( 〉함수를 사용한다. 


표 11-2. 오르내 리기조종체의 주되는 통보문 


UDM—GETBUDDY 

련동조종체의 손잡이를 얻는다. 돌림값으로서 손 
잡이 가 돌려 진다. wParam 과 IParam 에 령 을 설정 
한다. 

UDM_GETPOS 

현재 의 값을 얻 는다. 돌림 값의 아래 단어 에 현재 의 
값이 보관된다. wParam 과 IParam 에 령을 설정한 
다. 

UDM—GETRANGE 

현재값의 범위를 얻는다. 돌림값의 아래단어에 최 
대값이 보관되고 아래단어에 최소값이 보관된다. 
wParam 과 IParam 에 령 을 설 정 한다. 

UDM—SETBUDDY 

새 로운 련동조종체 를 설정한다. 직전의 련동조종 
체 의 손잡이 가 돌림 값으로서 돌려 진다. wParam 에 
새 로운 련동조종체의 손잡이를 설정 하고 IParam 에 
령을 설정 한다. 

UDM—SETPOS 

현재 의 값을 설정 한다. wParam 에 령 을 설정 한다. 
IParam 에는 새 토운 값을 설정 한다. 

UDM—SETRANGE 

현재범위를 설정한다. wParam 에 령을 설정한다. 
IParam 의 아래 단어 에 새 로운 최 대 값을 설 정 하며 아 
래단어 에 새 로운 최소값을 설정 한다. 
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돌리개조종체의 작성 

오르내리기조종체를 단독으로 사용해도 전혀 문제가 생기지 않지만 대부분의 경우 
편집 칸과 조합하여 사용한다. 이 미 설 명 한것 처 럼 이 조합을 돌 J /； 分조종/ T//(Spin control ) 
라고 부론다. 돌리 개 조종체 가 오르내 리 기 조종체 의 일 반적 인 사용방법이 므로 Windows 
2000 은 특별한 지원을 제공하고 있다. 즉 돌리개조종체는 완전히 자동화된 조종체 이므 
로 프로그람에서 직접 조종할 필요는 없다. 

돌리개 조종체 를 작성하려 면 오르내 리 기조종체 의 련동조종제로서 편집칸을 지 정하여 
야 한다. 이 렇게 하면 오르내 리 기조종체 가 조작될 때 마다 조종체의 새 로운 값이 편집칸 
에 자동적으로 표시된다. 

또한 편집칸의 값을 변경 하면 오르내 리 기 조종체 의 내 부적 인 계 수기 도 자동적 으로 변 
한다. 일반적 으로 편집칸은 프로그람의 자원파일 에서 정의된다. 이 장의 뒤부분에서 돌 
리개조종체의 실례를 보게 된다. 

추적[[ I 의 사용방법 

추적띠를 미22름조종체 iSXider control ) 라고 부르는 경우도 있다. 추적띠는 시각적효 
과가 큰 공통조종체 의 하나로서 립 체단일선택 등의 전자제 품에 있는 미 끄름조절기 에 류 
사한 외형을 가지고 있다. 추적띠는 조절범위내에서 이동할수 있는 미끄름조절기를 가지 
고 있다. 

외형상차이는 있지만 프로그람에서 추적띠와 흘림띠를 조종하는 방법은 대부분 같다. 
추적띠는 프로그람에서 실제의 장치를 모방할 때 특히 편리하다. 실례로 프로그람에서 
록음기의 주파수평형기를 모방한다고 하면 주파수의 표시와 설정을 진행하는데 추적띠를 
사용할수 있다. 다음에 추적띠의 외형을 보여 주었다. 



추적 띠를 작성 하려면 Create Window ( ) 또는 Create WindowEx ( )를 사용한다. 
Created 用 n 公 ow & O 에서는 확장형식을 설정할수 있다. 이 장에서 작성하는 추적띠의 실 
례 프로 그람에서 는 확장 형식을 사용 하지 않 는다. 추적 띠의 창문 콜라 스는 
TRACKBAR—CLASS 이 다. 

추적띠 의 형 식 

추적띠를 작성할 때 여러 가지 형식을 설정할수 있다. 주요 형식들을 표 11-3 에 주었 
다. 작은 선들이 표시되도록 7 BS ᅴ 4 t /： T 07 光:公5 형식을 설정하는것 이 일반적 이 다. 이 검 
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사표식은 띠의 눈금으로 된다. 


표 11-3. 추적띠의 형식 


TBS—AUTOTICKS 

추적 띠 에 자동적 으로 눈금을 표시한다. 

TBS HORZ 

수평 방향의 추적띠 로 한다.(체계설정) 

TBS—VERT 

수직방향의 추적띠로 한다. 

TBS_BOTTOM 

띠 의 밑 에 눈금을 표시한다 .( 수평 방향추적 띠 의 체 
계 설정) 

TBS—TOP 

띠 의 우에 눈금을 표시한다. 

TBS LEFT 

띠의 왼쪽에 눈금을 표시한다. 

TBS—RIGHT 

띠의 오른쪽에 눈금을 표시한다. (수직방향추적띠의 
체계 설정) 

TBS—BOTH 

띠의 량쪽에 눈금을 표시한다. 

TBS—TOOLTIPS 

추적 띠 에 도구설명 쪽지 를 표시한다. 체 계 설정 으로 
는이 도구설명 쪽지에 미끄름조절기의 현재 
위 치 가 표시된다. 


추적띠에 를보문들 보내기 

지금까지 설명한 다른 공통조종체들과 같이 SendMessage ( ) 함수를 사용하여 추적 
띠 에 통보문을 보낼수 있 다. 추적 띠의 주요 통보문들을 표 11-4 에 보여 주었 다. 


표 11-4. 추적띠의 기본통보문 


TBM_GETPOS 

현재위 치를 얻는다. wParam 과 IParam 에 령을 설 
정 한다. 

TBM_GETRANGEMAX 

추적띠의 범위의 최대값을 얻는다. wParam 과 
IParam 에 령 을 설정 한다. 

TBM—GETRANGEMIN 

추적띠의 범위의 최소값을 얻는다. wParam 과 
IParam 에 령 을 설정 한다. 

TBM—SETBUDDY 

추적 띠 의 련동조종체 를 지 정 한다. wParam 에 는 련 
동조종체의 위치를 설정한다. 령을 설정하면 련동조 
종체 가 오른쪽 또는 밑에 표시된다. 령 이 아닌 값을 
설정하면 련동조종체 가 왼쪽 또는 우에 표시된다. 
IParam 에 련동조종체 로 되 는 편집 칸의 손잡이 를 설 
정 한다. 

TBM.SETPOS 

현재위치를 설정한다. 추적띠를 다시그러기하는 경 
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우는 wParam 에 령 이 아닌 값을 설정 하고 다시 그리 
기 하지 않는 경 우에 는 령 을 설정 한다. IParam 에 는 
새로운 위치를 설정한다. 

TBM—SETRANGE 

추적띠의 범위를 설정한다. 추적띠를 다시그리기하 
는 경우에는 wParam 에 령 이 아닌 값을 설정 하고 
다시그리 기하지 않는 경 우에 는 령 을 설정한다. 
IParam 에는 범위를 설정한다. 최소값을 IParam 의 
아래 단어 에 설 정 하고 최 대 값을 IParam 의 웃단어 에 
설정 한다. 

TBM—SETRANGEMAX 

최대값을 설정 한다. 추적띠를 다시그리기하는 경우 
에 는 wParam 에 령 이 아닌 값을 설정 하고 다시 그리 
기하지 않는 경우에는 령을 설정한다. IParam 에는 
최대값을 설정한다. 

TBM—SETRANGEMIN 

최소값을 설정 한다. 추적띠를 다시그리기하는 경우 
에 는 wParam 에 령 이 아닌 값을 설정 하고 그렇지 
않은 경 우에 는 령 을 설정 한다. IParam 에 는 최소값을 
설정 한다. 

TBM_SETTIPSIDE 

추적띠에 도구설명쪽지를 표시할 위치를 설정한다. 
wParam 에 는 TBTS — TOP , TBTS _ BOTTOM , 
TBTS_LEFT 및 TBTS_RIGHT 의 어느 하나를 설 
정 한다. IParam 에는 령 을 설정 한다. 


추적 띠에 반드시 보내야 할 통보문에는 TBM — SETRANGE 와 TBM — SETPOS 와 두가 
지가 있다. 이 통보문들은 각각 추적띠의 범위와 초기위 치를 설정하기 위한것들이 다. 이 
값들을 추적 띠 의 작성 시 에 는 설 정할수 없 다. 

TBM—SETBUDDY H 를아 주목해 야 한다. 이 통보문을 사용하여 추적 띠 에 련동조 
종제를 결 합시 킬수 있 다. 오르내 리 기 조종체 의 경 우와 같이 추적 띠 의 련동조종체 도 일 반 
적 으로 편집칸으로 된 다. 

IParam 에는 련동조종체의 손잡이를 설정한다. wParam 에는 표시위치를 설정한다. 
wParam 에 령을 설정하면 련동조종체의 표시위치가 수평추적띠의 오른쪽 또는 수직추적 
띠의 밑으로 된다. wParam 에 령 이 아닌 값을 설정하면 련동조종체의 표시위 치가 수평 
추적띠의 왼쪽 또는 수직추적띠의 웃쪽으로 된다. 

추적띠에는 한개 이상의 련동조종체를 지정할수 있다. 두개의 련동조종체가 사용되는 
경 우에 는 그것 들 이 추적 띠 의 량쪽에 표시 된다.(상세한 내 용은 이 장의 뒤 부분에 있는 
추적띠에서 련동조종체를 사용하는 방법]을 참고할것) 


다시 한보 전진 
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추적[[ᅵ 의 ■지 문의 처 리 

추적띠 를 조작하면 추적띠 가 수평형 인가 수직형 인가에 따라 WM_HSCROLL 과 
WM_VSCROLL 중의 임의의 통보문이 생성된다. 실제 조작내용은 wParam 의 아래단어에 
보관되여 있다. 이 값을 통 X /문이라고 부론다. IParam 에는 통보문을 생성한 추적띠의 손 
잡이 가 보관되 여 있 다. 추적 띠 의 주요한 통지 문들을 표 11-5 에 제 시 하였 다. 


표 11-5. 추적띠의 기본 통지문 


TB_BOTTOM 

[ End ] 건이 눌러웠다. 미끄름조절기 가 최소위 치로 
이동했 다. 

TB ENDTRACK 

추적띠의 조작이 완료되였다. 

TB—LINEDOWN 

오른쪽 또는 왼쪽 방향건이 눌러웠다. 

TB.LINEUP 

왼쪽 또는 웃쪽방향건이 눌러웠다. 

TB_PAGEDOWN 

[Page Down ] 건이 눌리 웠든가 조절기 의 전방부분 
에서 마우스가 찰칵되였다. 

TB_PAGEUP 

[Page Up ] 건이 눌리 웠든가 조절기의 후방부분에 
서 마우스가 찰칵되였다. 

TB THUMBPOSITION 

마우스를 리용하여 조절기가 이동되였다. 

TB THUMBTRACK 

마우스를 리용하여 조절기가 끌기되였다. 

TB_TOP 

[ Home ] 건이 눌러웠다. 조절기가 최대위치로 이동 
했 다. 


추적띠의 조종은 자동화되여 있다. 실례로 사용자가 추적띠를 조작하면 자동적으로 
조절기의 표시위치가 변화되므로 이것을 프로그람에서 조작할 필요는 없다. 

참고 : 추적띠로부터 TB_THUMBTRACK 통보문 또는 TB_THUMBPOSITION 통보문 
을 받았을 때는 HIWORD ( wParam ) 의 값에 띠의 현재위치가 보관되여 있다. 추적띠의 
다른 통보문들에서는 이 값이 령으로 되여 있다. 


진행띠의 사용방법 


진행띠는 처리과정의 진행상황을 표시하는 작은 창문이다. 처리의 진행상황에 맞추 
어 띠가 왼쪽에서부터 오른쪽으로 채색되여 나간다. 띠가 완전히 채색되면 처리과정이 
끝났다는것을 의미 한다. 
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진행띠는 공통조종체들가운데서 가장 간단한 조종체의 하나이다. 진행띠는 창문콜라 
스에 PROGRESS-CLASS 를 지 정 하고 Create Window ( 는 Create WindowEx ( ；# 호 
출하여 작성한다. 

SendMessage( ) 를 사용하여 프로그람으로부터 진행 띠 에 통보문을 보낼수 있 다. 진 
행띠는 통보문을 보내지 않는다. 진행띠의 범위를 설정하거나 진행상황을 갱신하려면 진 
행띠 에 통보문을 보낸다. 진행띠의 주요 통보문들을 표 11-6 에 보여 주었 다. 


표 11-6. 진행띠의 기본통보문 


PBM_SETPOS 

진행띠의 위치를 지정한다. 직전의 위치가 돌려 진다. 
wParam 에 새로운 위치를 설정한다 . IParam 에 령을 설정 
한다. 

PBM_SETRANGE 

진행띠의 범위를 설정한다. 직전의 범위가 돌려 지며 돌 
림 값의 웃단어 에 는 최 대 값，아래단어 에 는 최 소값이 보관된 
다. wParam 에는 령을 설정한다. IParam 의 웃단어 에는 최 
대값，아래단어 에는 최소값을 보관하여 범위를 설정 한다. 

PBM_SETSTEP 

증가값 (걸 음수)을 설정한다. 직 전의 증가값이 돌려 진 
다. wParam 에 새 증가값을 설정한다 . IParam 에는 령 을 
설정 한다. 

PBM_STEPIT 

걸음수만큼 진행 띠 를 전진시 킨다. wParam 과 IParam 에 
령을 설정한다. 


체계설정으로 진행띠의 범위는 0〜100 으로 되여 있다. 그러나 이 범위는 0〜65535 
사이의 임의의 값으로 변경할수 있다. PBM_STEPIT 통 1 문을 보내여 진행띠의 진행상황 
을 변경할수 있다. 이 통보문을 보내면 진행띠의 현재위 치 가 사전에 정의된 걸음수만큼 
전진한다. 체계설정의 걸음수는 10으로 되여 있으나 임의의 값으로 변경시킬수 있다. 

진행띠의 위 치를 갱 신하면 띠의 채 색된 부분이 증가한다. 진행띠는 긴 처 리 과정의 
진행상황을 표시하는 목적에 사용되는것이므로 처리과정이 다 끝났을 때는 띠의 모든 부 
분이 채색되도록 한다. 

이전에는 진행띠에 형식을 설정할 필요가 없었으나 최근에 와서 두가지 형식이 추가 
되였다. 첫 형식은 PBS—SMOOTH 다. 체계설정으로 진행띠의 표시는 단계적으로 변화 
되지만 PBS _ SMOOTH 를 지정하면 진행띠의 표시가 련속적으로 원활하게 변화되게 된다. 

둘째 형식은 松次 T / 公 1 L 이 다. 이것은 진행띠를 수직으로 표시시키기 위한것 이 
다. 일반적으로 진행띠는 왼쪽에서 오른쪽으로 채색되여 나가지만 수직형의 진행띠에서 
는 아래에서 우로 올라 가면서 채색된다. 
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돌리개조종체, 추적띠 및 진행띠의 실례 


제 6 장의 앞부분에 서 작성 한 내 려 세 기 시 계 프로그람을 개 조하여 돌리 개 조종체 , 추적 
띠 및 진행띠와 실례프로그람으로 만들어 보자. 

이 프로그람에서는 시계의 시간간격의 s 수를 설정하는데 돌리개조종체를 사용한다. 
시계의 시간간격이 경과하였을 때 울리는 경보음의 회수를 설정하는데 추적띠를 사용한 
다. [Beep At End ] 가 선택되여 있지 않는 경우는 시계의 시간간격이 경과하였을 때 통 
보칸이 표시된다. 진행 띠에 는 내려세기의 진행상황이 표시된다. 확장판내려세기시계 프로 
그람의 완전한 프로그람 코드를 실례 11-1 에 주었다. 

실례 11-1. Ttaier 프로그람 


/* 내려세기시계에 돌리개조종체，추적띠 및 
진행띠를 추가한다. */ 

^include < windows. h> 
ttinclude <commctrl.h> 
ttinclude <cstring> 
ttinclude <cstdio> 
ttinclude "timer, h” 


Mefine BEEPMAX 10 
ttdefine MAXTIME 99 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM); 
BOOL CALLBACK DialogFunc(HWND, UINT, WPARAM, LPARAM) ； 

char szWinName[] =，，MyWin”; // 창문클라스의 이름 

HINSTANCE hlnst； 


HWND hwnd； 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 


LPSTR IpszArgs, int nWinMode) 
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MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 
INITCOMMONCONTROLSEX cc ； 


// 창문물라스를 정의 한다 . 

wcl. cbSize = sizeof (WNDCLASSEX) ; 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이론 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 

wcl. IpszMemiName = "TimerMenu" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) : 

// 창문콜라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문콜라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 

"Spin Controls, Trackbars, and Progess Bars", // 제목 
WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CW_USEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
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hThisInst, 

NULL 


NULL, 

NULL ， 


// 어미창문은 없다 . 

// 차림표는 없다 . 

// 실체의 손잡이 
// 추가파라메터 는 없 다 . 


hlnst = hThisInst ； // 현재실체의 손잡이를 보관한다 . 

// 건반가속기를 적재 한다 . 

hAccel = LoadAccelerators(hThisInst, "TimerMenu") : 

// 공통조종체를 초기 화한다 . 

cc.dwSize = sizeof (INITCOMMONCONTROLSEX) ; 
cc.dwICC = ICC_BAR_CLASSES | ICC_UPDOWN_CLASS | 
ICC_PROGRESS_CLASS : 

InitCommonControlsEx (&cc) : 

// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while(GetMessage(&msg, NULL, 0, 0)) 

{ 

if (! TranslateAccelerator (hwnd, hAccel, 技 msg)) { 
TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage(Smsg) ; // Windows 2000 에 조종을 넘 긴다 . 


return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 


WPARAM wParam, LPARAM IParam) 
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{ 

int response; 


switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM_DIALOG: 

DialogBox(hInst, ” MYDB”, hwnd, (DLGPROC) DialogFunc) ； 
break ； 

case IDM.EXIT ： 

response = MessageBox(hwnd, "Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O) ； 
break ； 

case IDM_HELP: 

MessageBox(hwnd, "Try the Timer", "Help”, MB_OK); 
break ； 

} 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보 문은 
Windows 2000 에 처 리 률 맡긴 다. */ 
return DefWindowProc(hwnd, message, wParam, lParam); 

} 

return 0 ； 

} 

// 시계의 대화함수 

BOOL CALLBACK DialogFunc (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM lParam) 

{ 

char str [80] ； 

HDC hdc ； 

PAINTSTRUCT paintstruct ； 
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static int t; 
int i; 

static long udpos = 1 ； 
static long trackpos = 1 ； 
static HWND hEboxWnd ； 
static HWND hTrackWnd ； 
static HWND udWnd ； 
static HWND hProgWnd ； 
int low=l, high=BEEPMAX ； 


switch (message) { 
case WMJNITDIALOG ： 
hEboxWnd = GetDlgItem(hdwnd, IDD.EBl) ； 

// 오르내 리기조종체를 작성 한다 . 
udWnd = CreateUpDownControl ( 

WS.CHILD | WS_BORDER | WS.VISIBLE | 
UDS.SETBUDDYINT | UDS.ALIGNRIGHT, 
10, 10, 50, 50, 
hdwnd, 

IDD 一 UPDOWN, 
hlnst, 

hEboxWnd, 

MAXTIME, 1, udpos) ； 

// 추적띠를 작성한다 . 

hTrackWnd = CreateWindow (TRACKBAR.CLASS, 
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)； 


WS.CHILD | WS_VISIBLE | WS_TABSTOP | 
TBS-AUTOTICKS | WS_BORDER, 

2, 50, 

200, 28, 
hdwnd, 

NULL, 

hlnst, 

NULL 
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SendMessage (hTrackWnd, TBM_SETRANGE, 

1, MAKELONG(low, high ))； 
SendMessage (hTrackWnd, TBM_SETPOS, 

1, trackpos); 

// 진행띠를 작성한다 . 

hProgWnd = CreateWindow (PROGRESS_CLASS, 


WS_CHILD | WS_VISIBLE | WS_BORDER, 
2, 84, 

240, 12, 
hdwnd, 

NULL, 

hlnst, 

NULL )； 


// 중가걸음을 1 로 한다 . 

SendMessage (hProgWnd, PBM_SETSTEP, 1, 0); 

// 「 As-Is 」 단일선택단추를 선택상래로 한다 . 

SendDlgltemMessage (hdwnd, IDD_RB3, BM_SETCHECK, 1, 0) ； 

// 「 Beeps 」 편집칸에 수값을 설정한다 . 

SetDlgltemlnt (hdwnd , IDD_EB2, trackpos, 1); 
return 1 ； 

case WM_VSCROLL ： // 10s 의 설정 으로 경보음을 울린다 . 
if (udWnd== (HWND)IParam) // 돌러 개조종체의 경우 
if(! (HIWORD(wParam) % 10)) MessageBeep (MB_OK) ; 
return 1 ； 

case WM_HSCROLL ： // 추적 띠 가 능동 
ifChTrackWnd != (HWND)IParam) break ； // 추적띠가 아닌 경우 


switch (LOWORD (wParam)) { 
case TB_TOP ： 

case TB_BOTTOM ： // 이 실례프로그람에서는 

case TB_LINEUP ： // 모든 통보문들을 

case TB_LINEDOWN ： // 같은 방법 으로 

case TB_THUMBPOSITION : // 처 리 한다 . 
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case TB 一 THUMBTRACK: 
case TB-PAGEUP: 
case TB_PAGEDOWN: 

trackpos = SendMessage (hTrackWnd, TBM_GETPOS, 

0 , 0)； 

SetDlgltemlnt (hdwnd, IDD_EB2, trackpos, 1); 
return 1; 

} 

break ； 

case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDCANCEL ： 

KillTimer(hdwnd, IDD.TIMER) ； 

EndDialog (hdwnd, 0); 
return 1 ； 
case IDD_EB2: 

A 사용자가 [Beeps] 편집 칸에 수값을 입력하면 
추적띠를 갱신한다. */ 

trackpos = GetDlgltemlnt (hdwnd, IDD_EB2, NULL, 1); 
SendMessage (hTrackWnd, TBM_SETPOS, 1, trackpos) ； 
return 1 ； 

case IDD.START: // 시계률 기동시 킨다. 

SetTimer(hdwnd, IDD_TIMER, 1000, NULL )； 

// 설정된 s 수를 엄는다. 

t = udpos = SendMessage (udWnd, UDM_GETPOS, 0, 0) ； 
// 진행띠를 초기화한다. 

SendMessage (hProgWnd, PBM.SETRANGE, 0, 
MAKELONG(0, udpos ))； 

SendMessage (hProgWnd, PBM.SETPOS, 0, 0 )； 

if (SendDlgltemMessage (hdwnd, 

IDD.RB1, BM.GETCHECK, 0, 0)) 
ShowWindow (hwnd, SW_MINIMIZE); 
else 

if (SendDlgltemMessage (hdwnd, 

IDD_RB2, BM.GETCHECK, 0, 0)) 
ShowWindow (hwnd, SW_MAXIMIZE) ； 
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return 1； 

} 

break； 

case WM_TIMER : // 시계의 설정시간이 경과했다. 

tf(t==0) { 

KillTimerChdwnd, IDD_TIMER) ; 

// 경보음을 울리든가 통보칸을 표시 한다. 
if (SendDlgltemMessage (hdwnd, 

IDD_CB2, BM_GETCHECK, 0, 0)) { 

// 경보음을 울릴 때마다 추적띠를 이동시킨다. 
for(i=trackpos； i； i—) { 

MessageBeep (MB_OK) : 

Sleep (1000) : 

SendMessage (hTrackWnd, TBM_SETPOS, 1, i-1) ； 

} 

// 내려세기후에 추적띠를 재설정한다. 

SendMessage (hTrackWnd, TBM_SETPOS, 1, trackpos) : 

} 

else MessageBox(hdwnd, "Timer Went Off", "Timer", MB_OK); 

SetDlgltemlnt (hdwnd, IDD_EB1, udpos, 1) ； 

ShowWindow (hwnd, SW_RESTORE); 
return 1； 

1 

t—； 

// 진행띠를 전진시킨다. 

SendMessage (hProgWnd, PBM_STEPIT, 0, 0); 

// 내 려세기상태를 표시 하는가를 검사한다. 
if (SendDlgltemMessage (hdwnd, 

IDD_CB1, BM_GETCHECK, 0, 0)) { 

SetDlgltemlnt(hdwnd, IDD_EB1, t, 1); 

} 

return 1； 
case WM_PAINT： 

hdc = BeginPaint (hdwnd, &paintstruct) : 

SetBkMode(hdc, TRANSPARENT) : 
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sprintf(str, "Seconds"); 

TextOut(hdc, 44, 6, str, strlen(str)) ； 
sprintf(str, ” Beeps”); 

TextOut (hdc, 186, 6, str, strlen(str)) ； 
sprintf(str, "Set Number of Beeps’’); 
TextOut(hdc, 30, 32, str, strlen(str)) ； 
EndPaint (hdwnd, &paintstruct) ； 
return 1； 


return 0； 

} 

이 프로그람에서 사용하는 자원파일을 실례 11-2 에 준다. IDD _ EB 1 로 표시되는 편 
집칸은 돌리 개 조종체 를 형 성하도록 오르내 리 기 조종체 와 결 합된 다. 

실례 11-2. Timer 2 프로그람 


// 돌리개조종체와 추적띠의 실례 
ttinclude〈windows. h> 
ttinclude ” timer, h” 

TimerMenu MENU 

{ 

POPUP M &Options" 

{ 

MENUITEM ” &Timer\tF2", IDM.DIALOG 
MENUITEM "E&xitXtCtrl+X' 1 , IDM_EXIT 

} 

MENUITEM ”&Help”, IDMJHELP 

} 

TimerMenu ACCELERATORS 

{ 

VK_F2, IDM_DIALOG, VIRTKEY 
VK_F1, IDM.HELP, VIRTKEY 
『X，，, IDM_EXIT 

} 
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MYDB DIALOGEX 18, 18, 144, 100 
CAPTION ” A Countdown Timer" 

STYLE DS_MODALFRAME | WS.POPUP | WS.CAPTION | WS.SYSMENU 

{ 

PUSHBUTTON ” Start", IDD.START, 30, 80, 30, 14 
PUSHBUTTON "Cancel", IDCANCEL, 70, 80, 30, 14 
EDITTEXT IDD.EB1, 1, 1, 20, 12, ES.LEFT | WS.CHILD | 

WS_VISIBLE | WS.BORDER 

EDITTEXT IDD.EB2, 80, 1, 12, 12, ES.LEFT | WS 一 CHILD | 
WS_VISIBLE | WS_BORDER 

AUTOCHECKBOX "Show Countdown”, IDD_CB1, 1, 48, 70, 10 
AUTOCHECKBOX "Beep At End", IDD_CB2, 1, 58, 60, 10 
AUTORADIOBUTTON ” Minimize", IDD.RB1, 80, 48, 50, 10 
AUTORADIOBUTTON "Maximize”, IDD_RB2, 80, 58, 50, 10 
AUTORADIOBUTTON "As_Is”, IDD.RB3, 80, 68, 50, 10 

} 

머 리 부파일 TIMER. H 의 내 용은 다음과 같다 . 


ttdefine IDM_DIALOG 100 

#define IDM.EXIT 101 

ttdefine IDM.HELP 102 

#define IDD_START 300 

ttdefine IDD_TIMER 301 

Mefine IDD_CB1 400 

#define IDD_CB2 401 

Mefine IDD.RB1 402 

Mefine IDD_RB2 403 

#define IDD_RB3 404 

#define IDD_EB1 500 

Mefine IDD.EB2 501 

#define IDD_UPDOWN 602 


프로그람의 실 행결과를 그림 11-1 에 보여 주었 다 . 
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그림 11-1. 확장판시 계 프로그람의 실 행 결과 


시 계를 개시할 때 ([Start] 단추를 누른다.) 돌리개조종체 로부터 시계의 시 간간격 을 
얻는다. [Show Countdown] 에 검사표식 이 붙어 있는 경우에는 시간이 경과할 때마다 
돌리개조종체에 표시되는 남은 시간이 갱신된다. 

시 계 의 시 간간격 이 경 과하면 지 정 된 회 수만큼 경 보음이 울린 다 . ([Beep At End] 가 
선택되여 있는 경우) 또한 경보음이 울릴 때마다 추적띠의 위치가 왼쪽으로 이동한다. 
확장판 내 려세기시계프로그람의 내용을 상세히 보자. 


|다시 한보 전진| 


Sleep( ) 함수 

내 려세 기 시 계 프로그람에 서 는 시 계 의 설정 시 간이 경 과했을 때 경 보음을 련속적 
으로 울러게 하기 위 해 Sleep() 할年를 사용하고 있 다. 경보음의 시 간간격 이 짧으 
면 끊기지 않는 하나의 련속적인 음으로 들리게 된다. 이러한 시간간격을 얻기 위 
해 쏘프트웨어 에 의 한 지 연순환을 사용하였다. 아래 에 그 실례 를 보여 주었 다. 

for ( x =0； x <100000； x ++) ； 公 단순한 지 연순환 

그러나 이러한 쏘 프트웨 어적인 수법에는 두가지 문제점이 있다. 첫번째 문제 
점 은 쏘 프트웨 어 의 지 연순환이 시 간적 으로 정 확치 않다는것 이 다. 그것 은 지 연시 
간이 CPU 의 속도에 따라 차이나기때문이다. 속도가 빠른 름퓨터에서는 지연시 
간이 짧게 되고 속도가 뜬 름퓨터에서는 지연시간이 길게 된다. 

또한 CPU 의 속도가 같다고 하여도 사용하는 번역프로그람이 다르면 순환명 
령을 서로 다른 기계어코드로 변환하게 된다. 이것도 지연시간을 부정확하게 하 
는 원인으로 된다. 

두번째 문제 점 은 쏘프트웨어의 지 연순환이 CPU 에 공연한 부하를 준다는것 
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이다. 지연순환안에서 아무런 처리도 하지 않고 있다고 해도 체계에서 실행되고 
있는 다른 프로세스의 CPU 시간을 랑비하게 된다. 

이 두가지 문제 점 을 극복하기 위해서 Windows 2000 에서는 함수를 

사용하여 지연시간을 얻도록 해야 한다. Sleep ( ) 함수는 ms 단위로 지정된 시간만 
큼 프로그람의 실행을 정지시킨다. 아래에 프로그람코드를 보여 주었다. 

VOID Sleep (DWORD delay ); 

delay 에 Sleep ( ) 함수를 호출하고 있는 스레드를 정지시킬 시간을 破단위로 
설정한다. 프로그람이 실행 중지상태 로 되 여 있는 동안에 CPU 시 간은 체 계 에서 
실행되고 있는 다른 프로세스에 할당된다. 


돌리 개조종체，추적[[I 및 진행 띠의 작성 

돌리개조종제，추적띠 말 진행[[ I 는 DialogFunc ( )A WMJNITDIALOG 통主문을 받았 
을 때 작성된다. 아래에 프로그람코드를 보여 주었다. 

case WMJNITDIALOG： 

hEboxWnd = GetDlgltem (hdwnd, IDD_EB1); 

// 오르내 리기조종체를 작성한다. 
udwnd = CreateUpDownControl ( 

WS_CHILD | WS_BORDER | WS_VISIBLE | 

UDS—SETBUDDYINT | UDS 一 ALIGNRIGHT， 

10, 10, 50, 50, 
hdwnd, 

IDD-UPDOWN, 

hlnst, 

hEboxWnd, 

MAXTIME, 1, udpos); 

// 추적띠를 작성한다. 

hTrackWnd = CreateWindow (TRACKBAR_CLASS, 

WS_CHILD | WS_VISIBLE | WS_TABSTOP | 

TBS_AUTOTICKS | WS_BORDER, 

2, 50, 

200, 28, 
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hdwnd, 

NULL, 

hlnst, 

NULL 

}； 

SendMessage (hTrackWnd, TBM.SETRANGE, 

1, MAKELONG(low, high)) ； 

SendMessage (hTrackWnd, TBM_SETPOS, 

1, trackpos) ； 

// 진행띠를 작성한다. 

hProgWnd = CreateWindow (PROGRESS.CLASS, 


WS_CHILD | WS.VISIBLE | WS_BORDER, 

2, 84, 

240, 12, 
hdwnd, 

NULL, 

hlnst, 

NULL); 

// 중가걸음을 1 로 한다. 

SendMessage (hProgWnd, PBM.SETSTEP, 1, 0)； 

// [Beeps] 편집 칸에 수값을 설정한다. 

SetDlgltemlnt (hdwnd, IDD—KB2, trackpos, 1); 

return 1； 

우선 CreateUpDownControl ( ) 을 호출하는 부분을 보자. 여기 에서는 대화칸의 
(10,10) 위치에 돌리개조종체를 작성하고 있다. 조종체의 너비는 50 화소이며 높이도 50 
화소이 다. 조종체는 대화칸의 새끼창문으로 되므로 어미창문의 손잡이로서 대화칸의 손 
잡이 ( hdwnd ) 가 설정 되 여 있다. 

오르내 리 기 조종체의 ID 는 IDD_UPDOWN 이 다. hlnst 는 프로그람실체의 손잡이 이 
다. 련동조종체는 hEboxWnd 에서 지정되고 있다. 이것은 오르내리기조종체에 결합되 
는 편집칸의 손잡이 이다. 오르내 리기조종체의 범위는 1〜 MAXTIME 이며 초기값은 1 로 
되여 있다. 

돌리개조종체와 결합되는 편집칸이 자원파일에 정의되여 있으므로 그것의 손잡이를 
얻 기 위 해 G 하 DlgltemO 을 호출하여 야 한다. (제 5 장에 서 GetDlgItem () 에 대 하여 설명 
하고 있다.) 
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편집칸의 손잡이 를 엄 으면 그것 을 GetUpDownControlO 함수의 련동조종체 를 가리 
키 는 파라메터 에 설 정한다. 편집칸을 련동조종체 로 하여 오르내 리 기조종체 를 작성 하면 
두개의 조종체가 자동적으로 결합되여 돌리개조종체로 된다. 

다음 추적띠를 작성하고 있는 부분을 보자. 추적띠의 위치는 (2,50) 이며 크기는 너 
비 가 28화소, 높이 28화소로 되 여 있다. 추적띠의 손잡이가 hTrackWnd 에 보관된다. 추 
적띠를 작성한 다음 그의 범위를 1 〜 BEEPMAX 로 설정하고 초기위치를 1 로 설정한다. 
MAKELONGC) 마모로를 사용하여 범위를 설정 하고 있다는데 주의를 돌려 야 한다. 이 마 
크로는 두개의 옹근수값을 하나의 긴 옹근수로 결합한다. 마크로의 선언은 다음과 같다. 


DWORD MAKELONG (WORD low , WORD high ) : 


두배단어 의 아래 값을 low 에 설정 하고 웃값을 high 에 설정한다. MAKELONG ( ) 
은 두 단어의 값을 긴 옹근수값으로 변환하는 경우에 편리하다. 

마지막으로 진행띠를 작성하고 있는 부분을 보자. 진행띠는 추적띠의 가까이에 배치 
되고 걸음수에 1 을 설정하고 있다. 시계의 설정시간이 경과할 때마다 진행띠가 갱신되 
여 현재의 내려세기상황을 표시한다. 

돌리개조종제의 조종 

돌리개조종제가 조작되면 대화칸에 WM_VSCROLL 통보문을 보낸다. 이때는 오르내 
리 기 조 종 체 의 손 잡 이 가 IParam 에 보 관 되 여 있 다 . 이 손 잡 이 의 값 과 
CreateUpDownControl () 에서 돌려 진 값을 비 교하여 통보문이 실제 로 오르내 리 기조종 
체에서 보내는가를 검사한다. 

이 실례프로그람에서는 같은 통보문을 보내는 조종체는 없으나 실제의 응용프로그람 
들에서는 여러개의 조종체에서 WM _ VSCROLL 통보문을 보낼 가능성도 없지 않다. 그러 
므로 통보문을 보낸 조종체를 항상 검사해 야 한다. 

돌리개조종체의 새로운 위치는 HIWORD ( wParam ) 에 보관되여 있다. 이 값이 10의 
배수일 때는 경보음을 울린다. 사용자가 시 간간격을 증가하거 나 감소시키면 그 값이 10 
의 배수로 될 때마다 경보음이 울린다. 이 기능은 긴 지연시간을 설정하는 경우에 편리 
할것 이 다. 

돌러개조종체의 조종은 완전히 자동화되 여 있으므로 WM_VSCROLL 통보문의 처 리 
밖에는 아무것도 할 필요가 없다. 10 의 배수에서 경보음을 울리게 하지 않는다면 
WM_VSCROLL 통보문을 처 리할 필요도 없다. 사실 돌리개조종체를 사용하는 대부분의 
프로그람들에서는 현재의 설정값을 얻는것외에 조종체를 조종하는 경우가 없다. 

IDD_START 를 처 리 하고 있는 부분에서 는 UDM_GETPOS 를 돌리 개 조종체 의 현재 
의 값을 얻고 있다. 이 통보문을 받으면 돌리개조종체는 련동조종체에 표시되여 있는 값 
을 돌려 준다. 편집칸의 값이 항상 돌리 개 조종체 의 현재 의 값을 표시 하고 있 다는데 주의 
를 돌려야 한다. 이것 은 사용자가 수동적으로 새 로운 값을 입 력 한 경우에 도 갈다. 
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추적[[ᅵ 의 조종 

추적띠가 이동되면 WM_HSCROLL 통보문을 보내여 아래와 같은 처리가 진행된다. 
case WM_HSCROLL： II 추적띠가 능동 

if(hTrackWnd != (HWND)lParam) break； // 추적띠가 아닌 경우 


switch (LOWORD (wParam)) { 
case TB_TOP: 
case TB_BOTTOM： 
case TB_LINEUP: 
case TB_LINEDOWN： 
case TB_THUMBPOSITION: 
case TB_THUMBTRACK: 
case TB_PAGEUP： 
case TB—PAGEDOWN: 
trackpos = SendMessage (hTrackWnd, TBM_GETPOS, 

0 , 0)； 

SetDlgltemlnt(hdwnd, IDD_EB2, trackpos, 1); 
return 1； 

} 

break； 

사용자가 추적띠의 조절기를 움직이면 추적띠의 위치가 자동적으로 갱신된다. 따라 
서 그 처리를 프로그람에서 진행할 필요는 없다. 추적띠의 동작이 끝나면 프로그람에서 
는 새로운 위치를 얻고 그 값을 경보음의 회수를 가리키는 편집칸에 설정한다. 

추적 띠의 현재 값은 SetDlgltemlnt () 을 사용하여 [ Beeps ] 편집 칸에 표시된다. 이 함 
수는 편집칸에 옹근수값을 표시 한다. 선언은 다음과 같다. 

BOOL SetDlgltemlnt (HWND hDialog , int ID , UINT value , BOOL 
signed ) : 

hDialog 에는 편집칸을 포함하고 있는 대화칸의 손잡이를 설정하고 ID 에는 편집칸 
의 ID 를 설정 한다. value 에 편집칸에 표시 시 킬 값을 설정 한다. signed 에 령 이 아닌 값 
을 설정한 경우는 value 에 부의 값을 설정할수 있게 된다. 그렇지 않은 경우에는 값이 
부호가 없는것으로서 인정된다. 이 함수는 호출이 성공하면 령 아닌 값을 돌려 주며 실 
패 하면 령을 돌려 준다. 

사용자가 [ Beeps ] 편집칸을 사용하여 수동적 으로 경 보회 수를 설정할수도 있다. 이 
경우에는 사용자가 입력한 값이 다음의 프로그람코드에서 추적띠에 반영된다. 


// 이 실례프로그람에서는 
// 모든 통보문을 
// 갈은 방법으로 
// 처 리한다. 
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case IDD_EB2: 

/* 사용자가 [Beeps ] 편집칸에 수값을 
입력하면 추적띠를 갱신한다 . */ 
trackpos = GetDlgltemlnt (hdwnd, IDD_EB2, NULL, 1); 

SendMessage (hTrackWnd, TBM_SETPOS, 1, trackpos) : 
return 1 ； 

편집 칸안의 값이 GetDlgltemlnt ( M 의해얻어 진다는데 주의를 돌려 야한다. 이 
함수는 편집칸에 현재 표시된 문자렬을 옹근수값으로 변환하여 돌려 준다. 

실례 로 편집 칸에 102 라는 문자렬 이 표시되 여 있다면 GetDlgltemlnt () 경\ 돌림 값은 
102 라는 옹근수값으로 된다. 여 러 가지 리 유로부터 이 기 능은 수자를 표시 하는 편집칸에 
만 적용된다. GetDlgltemlnt () 항今의 선언은 다음과 같다. 

UINT GetDlgltemlnt(HWND hDialog,int ID,BOOL * error,BOOL signed ); 

편집칸을 포함하고 있는 대 화칸의 손잡이 를 hDialog 에 설정 한다. ID 에 는 편집 칸의 
ID 를 설정 한다. 편집 칸에 수값으로 변환할수 있는 문자렬 이 표시 되 여 있지 않는 경 우에 
는 령이 돌려 진다. 그러나 령도 하나의 수값이므로 함수의 호출이 성공하였는가 아닌가 
는 error 에 돌려 지 게 되 여 있 다. 

함수를 호출하여 error 에 령 아닌 값이 돌려 졌다면 함수의 돌림값은 유효한것 이 다. 
오유가 발생한 경우에는 error 에 령 이 돌려 진다. 오유를 무시해도 상관이 없다면 이 
파라메 터 에 NULL 을 설정해 야 한다. signed 에 령 아닌 값을 설정 한 경 우는 
GetDlgltemlnt ) 가 부호 있는 값을 돌려 준다. 그렇 지 않은 경우에 는 부호 없는 값이 
돌려 진다. 

이 실 례프로그람은 추적 띠 를 마우스나 건반의 임 의 의 것 으로 동작시 킬수 있게 되 여 
있다. 프로그람에서 많은 TB _ 통보문을 처리하고 있는것은 건반입력을 지원하고 있기때 
문이 다. 이 통보문들을 몇 개 삭제하여 그 결과를 확인해 볼수도 있 다. 

진행띠의 조종 

진행띠는 내 려 세 기 의 진 행 상황을 표시 한다. 내 려 세 기 의 진 행 상황을 정 확히 표시 하려 
면 진행 띠범위의 최 대 값을 내 려세기의 초수에 맞추어 야 한다. 진행 띠의 초기 값은 령 으로 
해 야 한다. 

이러한 처리들은 IDD_START 의 case 문에서 진행되는데 이것은 사용자가 [ Start ] 
단추를 눌렀을 때 실행된다. 아래에 프로그람코드를 보여 주었다. 


// 진행띠를 초기화한다 . 
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SendMessage(hProgWnd, PBM_SETRANGE, 0, 

MAKELONGCO, udpos) : 

SendMessage(hProgWnd, PBM_SETRANGE, 0, 0); 

udpos 에는 돌리개조종체에서 설정된 초수가 보관되여 있다. 시계의 설정시간이 경 
과하면 아래 의 프로그람코드에 서 진행띠 가 갱 신된 다. 

"진행띠를 전진시킨다 . 

SendMessage (hProgWnd, PBM_STEPIT, 0, 0 )； 

이 리하여 진행띠의 위 치는 한걸음 앞으로 전진한다. 

간단한 코드로 고급한 기능의 실현 


앞에서 본것처럼 아주 간단한 코드만으로 오르내리기조종체, 추적띠 및 진행띠를 프 
로그람에 받아 들일수 있었 다. 그러 나 그 결과는 매 우 큰것 이 다. 제 6 장에서 작성한 내 
려세 기시계 프로그람과 이 장에서 작성한 확장용 내 려세 기시계프로그람의 모양, 조작기능 
을 비 교해 보면 어 느 프로그람이 보다 시 각적효과가 큰 대 면부를 가지 고 있는가를 명 백 
히 알수 있다. 


|다시 한보 전진| 


추적띠에서 련동조종제를 사용하는 방법 

이 미 설 명한것 처 럼 최 근에 와서 추적띠 에 련동조종제를 결 합시키 는 기 능이 
추가되 였 다. 오르내 리 기조종체 의 경 우와 같이 추적 띠 의 련동조종체 는 일 반적 으로 
편집칸느로 된다. 

추적 띠 에 련동조종체 를 결 합하려 면 추적 띠 를 작성한후에 TBM_SETBUDDY 
통보문을 보내야 한다. 이때 IParam 에 련동조종체의 손잡이를 설정하고 
wParam 에는 련동조종체의 위 치를 설정 한다. 

수평추적띠의 왼쪽 또는 수직추적띠의 밑에 련동조종체를 배치하려는 경우에 
는 wParam 에 령을 설정한다. 수평추적띠의 왼쪽 또는 수직흘림띠의 오른쪽에 
련동조종체 를 배 치 하는 경 우에 는 wParam 에 령 아닌 값을 설정 한다. 

추적띠는 하나 혹은 두개의 련동조종체를 가질수 있으며 련동조종체를 두개 
가지는 경우에는 그것들이 추적띠의 량쪽에 표시된다. 

이 장의 실 례프로그람을 개 조하여 [ Beeps ] 편집칸을 추적 띠 의 련동조종체 로 
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만들어 보자. 우선 WM_PAINT 통보문을 처 리하는 case 문에서 아래의 부분은 필 
요 없 으므로 삭제한다. 

sprintf (str, “Beeps”) : 

TextOut(hdc, 186, 6, str, strlen(str)) : 

다음은 추적 띠 를 작성한후에 TBM _ SETBUDDm 문* 보내 도록 한다. 

SendMessage (hTrackWnd, TBM_SETBUDDY, 0, (LPARAM) 

GetDlgItem(hdwnd, IDD_EB2)); 

GetDlgItem ( ) 은 돌림 값으로서 [ Beeps ] 편집 칸의 손잡이 를 돌려 주므로 그것 
을 추적띠의 련동조종체로서 설정한다. 이러한 변경을 진행하면 추적띠의 외형은 
아래와 같이 변화된다. 



교육성 프로그람교육멘터 


383 










제 12 장 


상태참문，표쪽조종체 및 
나무구조보기조종체 


이 장에 서 는 계 속하여 Windows 2000 의 공통조종체 들인 상태 창문，표 
쪽조종체 및 나무구조보기조종체들에 대하여 설명한다. 



제 12 장. 상태창문, 표쪽조종체 및 나무구조보기조종체 


상 태참문의 사용 방 법 


프로그람의 상태 나 속성 또는 어떤 파라메터 등의 정 보를 항상 표시해 두고 싶은 
경우가 흔히 있 다. Windows 2000 은 이러한 요구를 만족시 켜 주기 위 하여 상태 창문 
(Status window ) 또는 左法光分 (Status bar ) 라고 불러우는 조종체를 제공하고 있다. 

상태창문은 일반적으로 창문의 밑부분에 표시되는 띠로 되여 있다. 이 띠에 프로그 
람과 관계되는 정보가 표시된다. 

프로그람에 상태창문을 추가하는것은 아주 간단하다. 모든 응용프로그람들에서 상태 
창문을 리용하면 통일적 인 형식으로 상태정보를 표시할수 있다. 

상태참문의 작성 

상태 창문을 작성 하려 면 CreateStatusWindow ( /함수를 사용한다. 아래 에 선언을 보 
여 주었다. 

HWND CreateStatusWindow (LONG WinStyle , LPCSTR IpszFirstPart , 

HWND hParent , UINT ID ) : 


WinStyle 에 상태 창문의 형식을 설정 한다. 이 형 식 에는 WM—CHILD 를 포함시켜 야 
한다. 또한 일반적으로 상태창문이 자동적으로 표시되게 WS_VISIBLE 도 포함시킨다. 

상태창문을 두개 이상의 령역으로 갈라서 매 령역에 본문을 표시할수도 있다. 상태창 
문의 첫 령 역 에 표시 할 문자렬의 지 시 자를 IpszFirstPart 에 설정 한다. 이 문자렬을 후에 
설정 한다면 IpszFirstPart 에 NULL 을 설정 한다. 

어 미 창문의 손잡이 를 hParent 에 설정 하고 상태 창문의 식 별 자를 ID 에 설정 한다. 이 
함수는 상태창문의 손잡이를 돌려 준다. 함수의 호출이 실패한 경우에는 NULL 이 돌려 
진 다. 

상태창문을 작성할 때는 그 크기 나 위 치를 설정하지 않는다는 점 에 주의해 야 한다. 
그 리유는 상태창문이 자동적으로 어미창문의 아래부분에 적절한 크기로 배치되기때문이 
다. 만일 어 미창문의 웃부분에 상태창문을 배 치하려 고 한다면 WinStyle 파라메 터 에 
CCS — TOP 를 포함시킨다. SBARS _ TOOLTIPS (治은 방식의 마크로인 SBT _ TOOLTIPS 를 
사용할수도 있다.)를 포함시키면 도구설명쪽지를 표시할수도 있다. 

참고 : 창문콜라스에 STATUSCLASSNAME 볼 지정하고 CreateWindow ( ) 혹은 
CreateWindowEx ( ) 의 어느 하나를 사#하‘ 5 / 상태창문을 작성 할수도 있다. 그러나 
CreateStatusWindow ( )를 사용하는 편이 보다 간단하다. 
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상태 창문은 두개 이 상의 령역 으로 갈라서 리 용하는것 이 일 반적 이 다.(그러 나 령 역 이 
한개 라고 해 도 전혀 문제 가 없 다. ) 령 역 을 가르면 매 개 령 역 에 서 로 다른 본문을 표시 할 
수 있다. 매 령역은 색인에 의해서 참조된다. 선두령역의 색인은 령으로 된다. 이미 설 
명 한것 처 럼 상태 창문을 작성 할 때 선두령 역 에 표시 할 본문을 설 정 할수 있 다. 

상태참문의 통보문 

상태창문은 통보문을 생성 하지 않지만 SendMessage ( )를 사용하여 프로그람으로부 
터 상태창문에 통보문을 보낼수 있다. 상태창문에 보낼수 있는 주요한 통보문들을 표 
12-1 에 주었다. 

대부분의 응용프로그람들에서는 SB_SETPARTS 및 SB _ SETTEXT 통보문을 상태창 
문에 보낸다. 이 통보문들은 상태창문의 령역의 수와 매 령역에 표시할 본문을 설정한다. 
아래에 상태창문을 작성하기 위한 일반적 인 순서를 보여 주었다. 

* 상태 창문을 작성 한다. 

* SB_SETPARTS 통보문을 보내 여 령 역의 수를 설정 한다. 

* SB _ SETTEXT 통보문을 보내 여 매 령 역에 본문을 설정 한다. 

상태창문의 초기화가 끝나면 필요에 따라 SB _ SETTEXT 통보문을 보내여 매 령역에 
표시된 문자렬을 갱 신할수 있다. 


상태창문의 주요한 통보문 


SB_GETPARTS 


상태 창문령역 의 오른쪽 끝의 X 자리 표를 얻 는다. 상태 창 
문령역의 수가 돌려 진다.(호출이 실패한 경우는 령이돌 
려 진다.) wParam 에는 얻으러는 령역의 수를 설정한 
다 . IParam 에는 매개 령역의 오른쪽 끝의 X 자리표를 보관 
하기 위한 옹근수형 배 럴의 지 시 자를 설정 한다. 이 배 렬의 
크기는 적 어도 요구된 령역의 수이상이 여 야 한다. 창문의 
경계선에 접하고 있는 경우에는 X 자리표로서 -1 이 돌려 
진다. 
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SB—GETTEXT 

지정한 령역의 본문을 얻는다. 돌림값의 아래단어에 본 
문의 문자수가 보관된 다.아래단어 에 는 본문의 표시 방법 을 
지적하는 값이 보관된다. 이 값이 령이면 본문이 오목패 이 
게 표시 되 여 있 다. SBT_POPOUT 라면 본문이 도두라지 게 
표시된다 . SBT_NOBORDERS 라면 본문이 경계선이 없이 
표시된다. SBT_RTLREADING 이라면 본문이 오른쪽에서 
왼쪽으로 표시된다. wParam 에는 목적하는 령역의 색 인을 
설정한다. IParam 에 는 본문을 보관할 문자렬의 지 시 자를 
설정한다.(이 배렬의 크기는 지정된 령역에 표시되여 있는 
본문을 보관하는데 충분한 크기로 되여야 한다.) 

SB.SETPARTS 

상태 창문령역 의 수를 설정 한다. 호출이 성 공하면 령 아 
닌 값을 돌려 주며 실패하면 령을 돌려 준다 .wParam 에는 
령역의 수를 설정한다. IParam 에는 매개 령역의 오른쪽 끝 
의 X 자리표를 보관하고 있는 옹근수형배럴의 지시자를 설 
정 한다. 어 미 창문의 오른쪽 끝의 경 계 선을 지 정하는 경 우 
에는 -1을 설정 한다. 

SB-SETTEXT 

령역에 표시할 문자렬을 설정한다. 호출이 성공하면 령 
아닌 값이 돌려 지 고 실패하면 령 을 돌려 준다. wParam 
에는 본문을 설정하는 령역의 색 인과 본문의 표시 방법 을 
지정 하는 값을 OR 연산하여 설정 한다. 이 값이 령이면 본 
문이 오목패 이 게 표시 된다. (체 계설정) SBT_POPOUT 라면 
본문이 도드라지게 표시된다. SBT_NOBORDERS 라면 본 
문이 경계선이 없이 표시된다. SBT_OWNERDRAW 라면 
어미 창문이 본문을 표시 한다. SBT_RTLREADING 이 라면 
본문이 오른쪽에서 왼쪽으로 표시된다. IParam 에는 표시 할 
문자렬의 지시자를 설정한다. 

SB_SETTIPTEXT 

도구설 명 쪽지 본문을 설정 한다. wParam 에 는 도구설 명 쪽 
지본문을 표시할 령역의 색인을 설정한다. IParam 에는 표 
시 할 본문을 보관한 문자렬 의 지 시 자를 설정한다. 


상태참문의 사용방법 

실례 12-1 의 프로그람은 대화칸안와 설정정보를 표시하기 위해 상태창문을 사용하는 
프로그람이 다. 이 대 화칸에 는 돌리개조종체와 成 A 악 검사칸 장 두개의 단일선택단추 A 
있다. 상태창문아는 이 조종체들의 현재설정상태가 표시된다. 

이 프로그람을 번역할 때는 COMCTL 32 .LIB 를 련결해야 한다. 프로그람의 실행결 
과를 그림 12-1 에 보여 주었다. 
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실 례 12-1. Status 프로그람 
// 상래창문의 실례 

^include < windows. h> 
ttinclude <commctrl.h> 
ttinclude <cstdio> 
^include "status. h n 


#define NUMPARTS 5 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
BOOL CALLBACK DialogFunc(HWND, UINT, WPARAM, LPARAM) ； 
void InitStatus (HWND hwnd) ； 


char szWinNameG = "MyWin”; // 창문들라스의 이름 

HINSTANCE hlnst ； 

HWND hwnd ； 

HWND hStatusWnd ； 

int parts [NUMPARTS] ； 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 

INITCOMMONCONTROLSEX cc ； 

// 창문믈라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ； 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 

wcl. IpszClassName = szWinName ； // 창문들라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0 ； // 체계설정의 형식 
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wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ; // 큰 아이콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 

wcl.IpszMenuName = "StatusMenu" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) : 

// 창문콜라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문콜라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Using a Status Bar", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

)； 


hlnst = hThisInst ； // 현재실체의 손잡이를 보관한다 . 

// 건반가속기를 적재 한다 . 

hAccel = LoadAccelerators(hThisInst, "StatusMenu") : 
// 공통조종체를 초기화한다 . 

cc.dwSize = sizeof (INITCOMMONCONTROLSEX) ; 
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cc.dwICC = ICC_BAR_CLASSES | ICC.UPDOWN.CLASS ； 
InitCommonControlsEx (&cc); 


// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) ； 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

if (! Translate Accelerator (hwnd, h Accel, 技 msg)) { 
TranslateMessage(&msg) ； // 건반통보를 변환한다 . 
DispatchMessage(&msg) ； // Windows 2000 에 조종을 넘 긴다 . 

} 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

int response; 


switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 


case IDM_DIALOG: 

DialogBox (hlnst, "StatusDB", hwnd, (DLGPROC) DialogFunc) ； 
break ； 

case IDM.EXIT ： 

response = MessageBox(hwnd, "Quit the Program?”, 

” Exit，，, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O); 
break ； 
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case IDM_HELP ： 

MessageBox(hwnd, "Try the Dialog Box", 

” Help”, MB_OK) ； 

break ； 

} 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 

} 

return 0 ； 

} 

// 상래창문의 실례를 위한 대화함수 

BOOL CALLBACK DialogFunc (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

static long udpos = 0; 
static char str[80]; 
static HWND hEboxWnd ； 
static HWND udWnd ； 
static statusCBl, statusCB2 ； 
static statusRBl ； 
int low=0, high=10 ； 


switch (message) { 
case WMJNITDIALOG ： 

InitStatus(hdwnd) ； // 상태 창문을 초기 화한다 . 

hEboxWnd = GetDlgltem (hdwnd, ID_EB1) ； 
udWnd = CreateUpDownControl ( 

WS.CHILD | WS.BORDER | WS.VISIBLE | 
UDS_SETBUDDYINT | UDS.ALIGNRIGHT, 
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10, 10, 50, 50, 
hdwnd, 

ID_UPDOWN, 

hlnst, 

hEboxWnd, 
high, low, high/2) ； 

// 단일선택단추를 초기 화한다 . 

SendDlgltemMessage (hdwnd, ID.RB2, BM_SETCHECK, 
BST.CHECKED, 0); 

return 1 ； 

case WM.VSCROLL ： // 오르내 리 기조종체 를 처 리 한다 . 
if (udWnd== (HWND) IParam) { 
udpos = GetDlgltemlnt (hdwnd, ID_EB1, NULL, 1); 
sprintf(str, "Power ： %d”, udpos) ； 

SendMessage (hStatusWnd, SB_SETTEXT, 

(WPARAM) 0, (LPARAM) str) ； 

} 

return 1 ； 

case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case ID_CB1: // 「 Optimize 」 검사칸을 처 리 한다 . 
statusCBl = SendDlgltemMessage (hdwnd, ID_CB1, 
BM.GETCHECK, 0, 0); 
if (statusCBl) sprintf (str, "Optimize ： Yes’’); 
else sprintf(str, "Optimize ： No"); 

SendMessage (hStatusWnd, SB_SETTEXT, 
(WPARAM) 1, (LPARAM) str )； 

return 1 ； 

case ID_CB2 ： // 「 Debug 」 검사칸을 처 러 한다 . 
statusCB2 = SendDlgltemMessage(hdwnd, ID_CB2, 
BM.GETCHECK, 0, 0); 
if(statusCB2) sprintf (str, ” Debug: Yes”); 
else sprintf (str, ” Debug: No’’); 

SendMessage (hStatusWnd, SB_SETTEXT, 
(WPARAM) 2, (LPARAM) str )； 

return 1; 

case ID_CB3 ： // 「NT 4 」검사칸을 처 리 한다 . 
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statusCB2 = SendDlgltemMessage (hdwnd, ID_CB3, 
BM_GETCHECK, 0, 0); 
if (statusCB2) sprintf (str, "NT 4 ： Yes") : 
else sprintf (str, "NT 4: No") : 

SendMessage (hStatusWnd, SB_SETTEXT, 
(WPARAM) 3, (LPARAM) str) ； 

return 1; 

case ID_RBl: // 단일선택 단추를 처 리한다 . 
case ID_RB2 ： 

statusRBl = SendDlgltemMessage (hdwnd, ID_RB1, 
BM_GETCHECK, 0, 0); 
if (statusRBl) sprintf (str, "Using C") : 
else sprintf (str, "Using C++") : 

SendMessage (hStatusWnd, SB_SETTEXT, 
(WPARAM) 4, (LPARAM) str )； 


return 1; 


case ID_RESET ： // 추가선택항목을 재설정한다 . 

SendMessage (udWnd, UDM_SETPOS, 0, (LPARAM) high/2); 
SendMessage ChStatusWnd, SB_SETTEXT, (WPARAM) 0, 
(LPARAM) "Power ： 5 ")； 

SendDlgltemMessage (hdwnd, ID_CB1, 

BM_SETCHECK, 0, 0 )； 

SendDlgltemMessage (hdwnd, ID_CB2, 

BM_SETCHECK, 0, 0); 

SendDlgltemMessage (hdwnd, ID_CB3, 

BM_SETCHECK, 0, 0); 

SendMessage (hStatusWnd, SB_SETTEXT, (WPARAM) 1, 
(LPARAM) "Optimize ： No") : 

SendMessage(hStatusWnd, SB_SETTEXT, (WPARAM) 2, 
(LPARAM) "Debug ： No") : 

SendMessage ChStatusWnd, SB_SETTEXT, (WPARAM) 3, 
(LPARAM) "NT 4 ： No"); 

SendMessage (hStatusWnd, SB_SETTEXT, (WPARAM) 4, 
(LPARAM) "Using C++") : 
return 1 ； 


case IDCANCEL ： 
case IDOK ： 

EndDialog (hdwnd, 0) : 
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return 1; 

} 

} 

return 0 ； 

} 

// 상태창문의 초기화 
void InitStatus (HWND hwnd) 
{ 

RECT WinDim ； 
int i; 


GetClientRect (hwnd, &WinDim); 

for(i=l ； i<=NUMPARTS ； i++) 
parts[i-1] = WinDim.right/NUMPARTS * i ； 

// 상태창문을 작성 한다 . 
hStatusWnd = CreateStatusWindow ( 

WS_CHILD | WS_VISIBLE, 

"Power ： 5", hwnd, 

正 LSTATUSWIN ); 

SendMessage (hStatusWnd, SB_SETPARTS, 

(WPARAM) NUMPARTS, (LPARAM) parts); 


SendMessage (hStatusWnd, SB_SETTEXT, (WPARAM) 1, 
(LPARAM) "Optimize ： No") : 

SendMessage (hStatusWnd, SB_SETTEXT, (WPARAM) 2, 
(LPARAM) "Debug ： No"); 

SendMessage (hStatusWnd, SB_SETTEXT, (WPARAM) 3, 
(LPARAM) "NT 4 ： No") : 


SendMessage (hStatusWnd, SB_SETTEXT, (WPARAM) 4, 
(LPARAM) "Using C++") : 


이 프로그람은 아래의 자원파일을 필요로 한다. 
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♦include "status, h" 

StatusMenu MENU 

{ 

POPUP "SOptions" { 

MENUITEM "&Dialog\tF2", IDM_DIALOG 
MENUITEM "E&xit\tCtrl+X", IDM_EXIT 

} 

MENUITEM "&Help", IDM_HELP 

} 

StatusMenu ACCELERATORS 

{ 

VK_F1, IDM_HELP, VIRTKEY 
VK_F2, IDM_DIALOG, VIRTKEY 
"~X", IDM_EXIT 

} 

StatusDB DIALOGEX 18, 18, 180, 92 
CAPTION "Demonstrate a Status Bar" 

STYLE DS_MODALFRAME | WS_POPUP | WS.CAPTION | WS.SYSMENU 

{ 

PUSHBUTTON ” Reset", ID.RESET, 112, 40, 37, 14 
PUSHBUTTON ”OK n , IDOK, 112, 60, 37, 14 
EDITTEXT ID_EB1, 10, 10, 20, 12, ES.LEFT | 

WS_BORDER | WS.TABSTOP 
LTEXT "Power Factor”, ID_STEXT1, 36, 12, 50, 12 
AUTOCHECKBOX "Optimize”, ID_CB1, 10, 35, 48, 12 
AUTOCHECKBOX "Debug Info", ID_CB2, 10, 50, 48, 12 
AUTOCHECKBOX "NT 4 Compatible", ID_CB3, 10, 65, 70, 12 
AUTORADIOBUTTON ”C", ID_RB1, 112, 8, 20, 12 
AUTORADIOBUTTON "C++”, ID_RB2, 112, 20, 28, 12 
LTEXT ， ’ Language”, ID_STEXT2, 140, 14, 40, 12 

} 

머리부파일 STATUS . 여의 내용을 아래에 보여 주었다. 
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#define IDM.EXIT 101 

Mefine IDM.HELP 102 

ttdefine ID.UPDOWN 103 

#define ID_EB1 104 

Mefine ID_EB2 105 

Mefine ID_CB1 106 

#define ID_CB2 107 

ttdefine ID_CB3 108 

Mefine ID_RB1 109 

#define ID_RB2 110 

Mefine ID.RESET 111 

#define ID_STATUSWIN 200 

#define ID_STEXT1 300 

Mefine ID.STEXT2 301 



그림 12-1. 상태창문프로그람의 실행결과 


이 프로그람에서는 InitStatus ( ) 함수에서 상태창문의 작성과 초기화를 진행한다. 

우선 GetClientRect ( ) 를 사용하여 대화칸의 크기를 얻 는다. 창문의 너비를 
NUMPARTS (이 옹근수의 값은 5 이 다.)로 나누어 상래창문의 매개 령역의 오른쪽 끝위 
치를 결정하고 그 값들을 배렬 parts 에 보관한다. 매 령역의 너비가 아니라 매 령역의 
오른쪽 끝의 위치를 상태창문에 설정한다는 점에 주목해야 한다. 

다음 상태창문을 작성하고 령역을 설정한다. 마감으로 매개 령역에 본문의 초기값을 
설정한다. (선두령역의 본문은 CreateStatusWindow ( ) 에서 설정한다.) 

DialogFunc ( ) 안에서는 조종체의 상태가 변경될 때마다 상태창문의 표시를 갱신하 
고 있다. 이것은 매 조종체에 대응되는 상태창문의 령역에 SB_SETTEXT 통보문을 보내 
여 실현된다. 
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상태창문의 령역에 표시되는 본문은 령역의 내부에 들어 맞도록 자동적으로 잘라 진 
다. 본문이 이웃한 령역을 침범하여 표시되는 일은 없다. 


|다시 한보 전진| 


상태창문의 크기변경 

상태창문의 크기는 어미창^아 맞추어 초기화되지만 어미창문의 크기가 변하 
면 상태창문의 크기도 그에 맞게 자동적으로 변화되지는 않는다. 

어미 창문 안에 있는 상태 창문 (새끼 창문) 의 크기를 변경 하려면 
SendMessage () 함수를 사용하여 어 미 창문으로부터 새끼 창문에 통보문 

을 보내 야 한다. (이 처 리는 제 10 장에서 설명 한 도구띠의 크기 변경 과 류사하다. ) 

앞서 본 실례 프로그람에 서 어 미창문인 대 화칸의 크기 가 변경 될 때 자동적으 
로 상태창문의 크기 가 변경되도록 하려면 DialogFunc ( ) 에 아래의 case 문을 추 
가해 야 한다. 

case WM_SIZE: 

SendMessage (hStatusWnd, WM_SIZE, wParam, IParam); 

GetClientRect (hdwnd, &WinDim) : 

for(i=l ； i<=NUMPARTS; i++) 
parts[i-1] = WinDim.right/NUMPARTS * i ； 

SendMessage (hStatusWnd, SB_SETPARTS, 

(WPARAM) NUMPARTS, (LPARAM) parts) ； 

return 1 ； 

DialogFunc ( ) 에는 아래의 변수도 추가하여 야 한다. 

RECT WinDim ； 

int i ； 

또한 대 화칸의 크기를 변경 가능하게 하기 위해 대 화칸의 자원에 
WS_SIZEBOX 형식을 포함시 켜 야 한다. 

이 러한 변경을 진행 하고 상태창문의 프로그람을 실행한 다음 대화칸의 크기 
를 변경해 보면 상태 창문의 크기 도 자동적 으로 변경 된 다는것 을 알수 있 다. 크기 
를 변경한 대 화칸을 아래 에 보여 주었 다. 
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표쪽조종체의 소개 


：5쪽조종乂/八 tab control ) 는 시각적효과가 큰 공통조종체의 하나이다. 표쪽조종체는 
여러개 서류철등록부의 표쪽들을 줄 지어 놓은것이다. 표쪽이 선택되면 그에 대응하는 
등록부가 전면에 표시된다. 

표쪽조종체의 사용방법은 간단하지만 그것을 실현하는 프로그람의 작성은 약간 복잡 
하다. 여기 에서는 표쪽조종체의 기 본적 인 기능에 대 해 설명한다. 다음 절에서는 표쪽조 
종체의 고급한 기능을 설명한다. 

표쪽조종체의 작성 

표쪽조종 체를 작성 하려면 창문들라스에 WC_ TABCONTROL 을 지정하고 
CreateWindow ( ) 또는 CreateWindowEx ( ) 를 사용한다. 표쪽조종체 는 새 끼창문 
( 、 WS_CHILD) 느로 된다. 또한 창문의 형식에 WS_VISIBLE 을 지정하여 표쪽조종체가 자 
동적으로 표시되게 하는것 이 일반적 이 다. 표쪽조종체를 작성 하기 위한 프로그람코드의 실 
례를 아래에 보여 주었다. 


hTabWnd = CreateWindowC 

WC-TABCONTROL, 


WS_YISIBLE | WS_TABSTOP | WS_CHILD, 
0 , 0 , 100 , 100 , 
hwnd, // 어미창문의 손잡이 
NULL, 

hlnst, // 실체손잡이 
NULL 
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}； 


표쪽조종체에 설정할수 있는 형식에는 여 러가지가 있다. 실례로 TCS_BUTTONS 는 
표쪽을 단추형 태 로 한다. 그러 나 대부분의 응용프로그람에서 는 체 계 설정형 식의 표쪽이 면 
충분하다. 표쪽조종체 가 작성 되 면 응용프로그람으로부터 표쪽조종체 에 통보문을 보낼 수 
있다. 표쪽조종체 가 조작되면 표쪽조종체가 통보문을 생성한다. 

작성된 직후의 표쪽조종체의 내부는 비여 있다. 표쪽조종체를 사용하기에 앞서 표쪽 
을 삽입하여 야 한다. 매 개 표쪽은 아래 에 보여 준 7 T 7： T £ M 구조체 에서 정의된다. 


typedef struct tagTCITEM 
{ 

UINT mask ； 

DWORD dwState ； 
DWORD dwStateMask ； 
LPSTR pszText ； 
int cchTextMax ； 
int ilmage ； 

LPARAM IParam ； 

} TCITEM ； 


TCITEM 구조체에서 mask 의 값은 dwState , pszText 및 ilmage 등의 성원에 유효 
한 값이 보관되여 있는가 아닌가를 가리키게 된다. mask 의 값은 아래에 보여 준 몇가지 
값들의 조합으로 된다. 


TCIFJMAGE 

ilmage 에 자료가 보관되 여 있 다. 

TCIF—PARAM 

IParam 에 자료가 보관되 여 있 다. 

TCIF—STATE 

dwState 에 자료가 보관되 여 있 다. 

TCIF—TEXT 

pszText 에 자료가 보관되 여 있 다. 


mask 에 TCIF_RTLREADING 라는 값을 포함시 킬수도 있다. 이것은 본문이 오른쪽 
에 서 왼쪽으로 표시 된다는것 을 가리킨 다. 

표쪽을 작성할 때는 dwState 의 값이 사용되지 않는다. 현재 존재하는 표쪽의 상태 
를 얻 는 때 dwState 에 정 보 가 보 관 된 다 . dwState 의 값은 령 , TCIS _ 
BUTTONPRESSED (단추형 태의 표쪽에서 만 사용) 혹은 TCIS _ HIGHLIGHTED (표쪽이 
강조표시되고 있다.)의 어느 한 값으로 된다. 

dwStateMask 의 값은 dwState 의 유효비 트를 지적 한다. dwStateMask 는 항목을 
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삽입할 때는 사용되지 않는다. 

표쪽을 설정 할 때 는 pszText 에 표쪽안에 표시될 문자렬의 지 시 자를 설정한다. 표 
쪽의 정보를 얻을 때는 pszText 에 본문을 보관할 배럴의 지시자를 설정한다. 이 경우 
에는 pszText 에서 지 적되는 배 렬의 크기를 cchTextMax 에 설정 한다. 

표쪽조종체에 화상목록을 련관시키는 경우에는 특정 한 표쪽에 련관시 킬 화상의 색 인 
을 ilmage 에 설정한다. 표쪽조종체에 련관시킬 화상목록이 없는 경우에는 ilmage 에 -1 
을 설정 한다. 이 장의 실례프로그람에서는 화상을 사용하지 않는다. 

IParam 에 는 응용프로그람자체 의 자료를 보관할수 있 다. 

이식과 관련한 요점 : TCITEM 구조체는 낡은 형인 TCJTEM 구조체를 치환한것이다. 
TCJTEM 구조체에서는 dwState 와 dwStateMask 가 미러 예 약된 성원으로 되여 있다. 


표쪽조종체에 통보문을 보내기 

SendMessageC ) 함수를 사용하여 표쪽조종체 에 통보문을 보낼수 있다. 표쪽조종체 에 
보내는 주요한 통보문들을 표 12-2 에 보여 주었다. SendMessageC) 의 사용을 대신하여 표 
쪽조종체에 통보문을 보내는 처리를 간략화해 주는 몇개의 마크로가 제공되고 있다. 


표 12-2. 표쪽조종체 의 주요한 통보문 


TCM_ADJUSTRECT 

표쪽조종체의 표시령역과 창문의 크기를 엇바꾸 
어 계 산한다. wParam 에 조작내 용을 설정 한다. 령 
아닌 값을 설정하면 보내여 진 표쪽조종체의 표시 
령역의 크기로부터 창문의 크기가 계산된다. 령을 
설정하면 보내 여 진 창문의 크기 로부터 표쪽조종 
체의 표시령역의 크기가 계산된다. 

IParam 에는 령 역의 크기를 가리 키는 RECT 구조 
체의 지시 자를 설정한다.(이것은 창문의 크기 혹 
은 표쪽조종체의 표시령역의 크기 로 된다.) 이 구 
조체에 계산결과도 돌려 진다. 

TCM_DELETEALLITEMS 

표쪽조종체의 모든 표쪽을 삭제한다. 호출이 성 
공하면 령 아닌 값을 돌려 주며 실패하면 령을 돌 
려 준다. wParam 과 IParam 에 는 령 을 설정 한다. 

TCM_DELETEITEM 

지정한 표쪽을 삭제한다. 호출이 성공하면 령 아 
닌 값이 돌려 지 고 실패하면 령 이 돌려 진다. 
wParam 에 는 삭제 할 표쪽의 색 인을 설정 한다. 
IParam 에 는 령 을 설정 한다. 
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TCM_GETCURSEL 

현재 선택되여 있는 표쪽의 색인이 돌려 진다. 
표쪽이 선택되여 있지 않는 경우에는 -1 이 돌려 
진다. wParam 과 lParam 에 는 령 을 설정 한다. 

TCM_GETITEM 

특정한 표쪽의 정 보를 엄 는다. 호출이 성 공하면 
령 아닌 값이 돌려 지 고 실패하면 령 이 돌려 진 
다. wParam 에 표쪽의 색 인을 설정한다. IParam 
에 는 표쪽의 정 보를 보관하기 위 한 TCITEM 구조 
체의 지시자를 설정한다. 

TCM_GETITEMCOUNT 

표쪽의 수를 돌려 준다 . wParam 과 IParam 에 는 
령을 설정한다. 

TCMJNSERTITEM 

새 로운 표쪽을 작성 (삽입 )한다. 호출이 성공하면 
삽입된 표쪽의 색 인이 돌려 지 고 실패하면 -1 이 
돌려 진다. wParam 에 는 삽입 할 표쪽의 색 인을 설 
정 한다. IParam 에 는 표쪽의 정 보를 보관한 
TCITEM 구조체의 지시 자를 설정한다. 

TCM_SETCURSEL 

표쪽을 선택한다. 마지 막으로 선택 되 여 있 던 표 
쪽의 색인이 돌려 진다. 마지막으로 선택되여 있 
던 표쪽이 없는 경우에는 -1 이 돌려 진다. 새로 
선택 하는 표쪽의 색 인을 설정 한다. IParam 에 는 령 
을 설정한다. 

TCM—SETITEM 

특정한 표쪽의 정보를 설정한다. 호출이 성공하 
면 령 아닌 값을 돌려 주고 실패하면 령 이 돌려 
진다. wParam 에 는 표쪽의 색 인을 설정한다. 
IParam 에는 표쪽의 정보를 보관한 TCITEM 구조 
체의 지시자를 설정한다. 


표 12-2 에 보여 준 통보문을 보내는 마크로들은 다음과 같다. 모든 마크로들에서 
hTabWnd 에 는 표쪽조종체 의 손잡이 를 설정 한다. 

VOID TabCtrl_AdjustRect (HWND hTabWnd , BOOL opera 仕 on , 

RECT * lpRect ) : 

BOOL TabCtrLDeleteAllltems (HWND hTabwnd ) : 

BOOL TabCtrl _ DeleteItem(HWND hTabwnd , int index ); 
int TabCtrl_GetCurSel (HWND hTabWnd ); 

BOOL TabCtrl_GetItem (HWND hTabWnd , int index , TCITEM * lpitem ); 

int TabCtrL GetltemCount (HWND hTabWnd ) : 

int TabCtrl _ Insertltem (HWND hTabwnd , int index , 
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CONST TCITEM * lpitem ) : 
int TabCtrL SetCurSel(HWND hTabWnd , int index ); 

BOOL TabCtrLSetltem (HWND hTabWnd , int index , 

TCITEM * lpitem ) : 

일반적으로 SendMessageC )를 사용하는것보다 마크로를 사용하는 편이 간단하다. 
표쪽조종체를 작성한 시점에서는 표쪽이 없다. 그러므로 적어도 한번이상 
TCM _ INSERTITEM 통生문욜 보내 야 한다. 

이 장의 실 례프로그람에 서는 사용되 지 않지 만 실제 의 응용프로그람에 서는 
TCM _ ADJUSTRECT 통主문을 사용하여 표쪽조종체 의 표시 령 역의 크기를 얻을수 있다. 

표쪽조종체를 작성할 때는 창문에 표쪽자체 만이 아니 라 어떤 정 보나 대 화칸을 표시하 
기 위한 령역도 필요하게 된다. 이 표시령역은 표쪽조종체의 창문에서 표쪽을 제외한 부 
분이 다. (다시말하여 어떤 정보를 표시하기 위 하여 표쪽조종체의 표시 령 역을 사용할수 있 
다.) 표쪽에 대응한 정보를 표시하는 표시령역의 크기를 얻어야 하는 경우도 있는것이다. 

표쪽조종체의 롬지문 

사용자가 표쪽조종체를 조작하면 竹찼 t 八/ DTiFF 통보문이 생성된다. 표쪽조종체는 선 
택상태의 변화를 두개의 통지문으로 알려 준다. 그것들은 TCN—SELCHANGE 과 
TCN—SELCHANGING 통보문이 다 . 

TCN_SELCHANGING 은 표 쪽 의 선 택 상 태 가 변 경 되 기 직 전 에 발 송 된 다 . 
TCN _ SELCHANGE 는 새로운 표쪽이 선택된후에 발송된다. 

WM_NOTIFY 통보문이 보내 졌을 때는 lParam 에 NMHDR 구조체(、我 10 장에서 설 
명)의 지시 자가 보관된다. 통지문은 NMHDR 구조체의 code 성원에 보관된다. 통보문을 
생성 한 표쪽조종체 의 손잡이 는 hwndFrom 성원에 보관된 다. 

표쪽조종체의 간단한 실례프로그람 

표쪽조종체의 사용방법을 보여 주는 간단한 프로그람을 실례 12-2 에 보여 주었다. 
이 프로그람에서는 [ Options ], [ View ] 및 [ Errors ] 라는 세개의 표쪽을 작성하고 있다. 
새로운 표쪽이 선택되면 그것을 알리는 통보가 표시된다. 프로그람의 실행결과를 그림 
12-2 에 보여 주었 다. 

실 례 12-2. Tab 프로그람 


// 표쪽조종체의 간단한 실례프로그람 

♦include 〈 windows. h> 
ttinclude <commctrl. h> 

♦include <cstdio> 
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LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
char szWinName[] = n MyWin”; // 창문들라스의 이름 

HINSTANCE hlnst； 

HWND hwnd； 

HWND hTabWnd； 

char TabName [] [40] = { 

，’ Options”, 

"View", 

"Errors” 

}; 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

MSG msg ； 

WNDCLASSEX wcl ； 

INITCOMMONCONTROLSEX cc ； 

// 창문들라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) : 

wcl.Mnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName; // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI.APPLICATION) ； // 큰 아이콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 

wcl.IpszMenuName = NULL ； // 들라스차림표는 없다 . 
wcl.cbClsExtra = 0 ； // 보조기억기령역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ； 

// 창문들라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 
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/* 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow( 
szWinName, // 창문믈라스의 이름 
"Using a Tab Control", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자리 표는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 높이 는 Windows 가 결 정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림 표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메터는 없다 . 

)； 


// 공통조종체를 초기 화한다 . 

cc.dwSize = sizeof (INITCOMMONCONTROLSEX) ; 
cc.dwICC = ICC_TAB_CLASSES : 

InitCommonControlsEx (&cc) : 

// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) : 

UpdateWindow (hwnd) : 

// 통보문순환고리를 작성한다 . 

while(GetMessage(&msg, NULL, 0, 0)) 

{ 

TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage(&msg) : // Windows 2M0 에 조종을 넘 긴다 . 

} 

return msg.wParam; 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 
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{ 

NMHDR *nmptr; 
int tabnumber ； 

HDC hdc ； 
char str [80] ； 

RECT WinDim ； 

TCITEM tci ； 

switch (message) { 
case WM.CREATE ： 

// 어미창문의 크기를 엄는다 . 
GetClientRect (hwnd, &WinDim) ； 


// 표쪽조종체를 작성 한다 . 
hTabWnd = CreateWindow ( 

WC_TABCONTROL, 

WS_VISIBLE | WS.TABSTOP | WS.CHILD, 

0, 0, WinDim. right, WinDim. bottom, 
hwnd, 

NULL, 

hlnst, 

NULL 

)； 

tci. mask = TCIF.TEXT ； 
tci. ilmage = -1; 

tci. pszText = TabName [0] ； 

TabCtrlJnsertltem (hTabWnd, 0, &tci) ； 

tci. pszText = TabName [1] ； 

TabCtrlJnsertltem (hTabWnd, 1, 技 tci); 

tci. pszText = TabName [2] ； 

TabCtrlJnsertltem (hTabWnd, 2, &tci) ； 
break ； 

case WM.NOTIFY ： // 표쪽의 변경을 처 리 한다 . 
nmptr = (LPNMHDR) IParam ； 
if(nmptr->code == TCN_SELCHANGE) { 
tabnumber = TabCtrl_GetCurSel ((HWND) nmptr->hwndFrom) ； 
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hdc = GetDC(hTabWnd) ； 

sprintf (str, "Changed to %s Tab. ", 

TabName [tabnumber]); 

SetBkColor(hdc, RGB(200, 200, 200)); 

TextOut(hdc, 40, 100, str, strlen(str)) ； 
ReleaseDC(hTabWnd, hdc )； 

} 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처리를 맡긴다 . */ 
return DefWindowProc (hwnd, message, wParam, IParam) ； 

} 


return 0; 



Options | View Errors | 


Changed to Errors Tab. 


그림 12-2. 표쪽조종제의 첫 실례프로그람의 실행결과 

이 프로그람에서는 표쪽조종체가 작성되기전에 GetClientRect () 를 사용하여 기본창 
문의 크기를 얻고 있다. 표쪽조종체를 작성할 때 그 크기가 어미창문의 의뢰자구역전체 
를 차지하게 하고 있다. 표쪽조종체의 크기는 임의로 해도 상관 없지만 이렇게 하는 경 
우도 흔히 있다. 표쪽조종체를 작성하고 나서 거기에 세개의 표쪽을 삽입하고 있다. 

TCN_SELCHANGE 를 포함한 WM_NOTIFY 통보문을 받으면 표쪽조종체 의 표시 령 
역에 표쪽의 선택상태가 변경되였다는것을 알리는 통보를 표시한다. 새로 선택한 표쪽의 
색 인은 TCM_GETCURSEL 통보문을 보내 여 얻을수 있다. 
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표쪽조종체의 사용방법 

표쪽조종체 를 작성하는것 은 간단하지 만 매 개 표쪽에 대 화칸을 련관시 키 는 약간 기 교 
적 인 사용방법도 적용할수 있다. 새로운 표쪽이 선택되면 그때까지 표시되여 있던 대화 
칸이 없어지고 새로운 대화칸이 표시된다. 

매 대화칸을 표쪽조종체의 표시령역의 크기에 맞추고 싶다고 생각할것이다. 이런 문 
제 를 비 롯하여 표쪽조종체 와 대 화칸을 련관시키 는 처 리 에는 복잡한 문제 점 들이 많이 존 
재하며 그것들을 이 책에서 모두 해결하는것은 불가능하다. 

여기에서는 표쪽조종체의 기본적인 사용방법만을 설명한다. 본질을 파악하면 필요한 
때 자체로 표쪽조종체에 여러가지 기능을 추가할수 있을것 이 다. 

아무때 나 새 로운 표쪽을 선택할수 있게 하려 면 비양식화대화칸을 사용하여 야 한다. 
그것은 비양식화대 화칸이 대 화칸을 표시한 상태 에서도 응용프로그람의 다른 부분을 능동 
으로 할수 있기때문이 다. (이것은 프로그람의 다른 부분을 사용하려 면 대 화칸을 닫아야 
하는 양식화대화칸과 다른 점 이 다.) 

새로운 표쪽이 선택되였을 때는 마지막으로 표시되여 있던 대화칸을 소거하고 새로 
운 대화칸을 능동으로 한다. 아무때 나 대화칸을 닫겨 지게 하려면 새로운 대화칸을 표시 
하기 전에 응용프로그람에서 적 절한 처 리 (실례 로 현재의 설정 상태 를 보관하는것 등)를 진 
행 하여 야 한다. 

실례 12-3 의 프로그람은 앞에서 작성한 실례 프로그람을 개조하여 세개의 표쪽에 대 
화칸을 표시하는것 이 다. 매 표쪽에 는 자체 의 비양식 화대 화칸이 련관되 여 있 다. 첫 대 화 
칸은 이 장의 앞부분에서 작성한 상태창문의 실례프로그람에서 사용된 대화칸이다. 다른 
두 대화칸은 그 어떤 기능도 수행하지 않는 허위적인것으로 작성되였다. 프로그람의 실 
행 결과를 그림 12-3 에 보여 주었 다. 

실례 12-3. Tab 2 프로그람 

// 표쪽조종체의 실례 

ttinclude < windows. h> 
ttinclude <commctrl. h> 

^include <cstdio> 
include ” tab.h ，， 


ttdefine NUMPARTS 5 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
BOOL CALLBACK DialogFuncl(HWND, UINT, WPARAM, LPARAM); 
BOOL CALLBACK DialogFunc2(HWND, UINT, WPARAM, LPARAM) ； 
BOOL CALLBACK DialogFunc3 (HWND, UINT, WPARAM, LPARAM) ； 
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void InitStatusCHWND hwnd) ； 

char szWinName[] = ，， MyWin”; // 창문들라스의 이름 

HINSTANCE hlnst ； 

HWND hwnd ； 

HWND hStatusWnd ； 

HWND hTabWnd ； 


int parts [NUMPARTS] ； 

HWND hDlg = (HWND) NULL ； 

char TabName [] [40] = { 
"Options”, 

"View", 

"Errors" 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

MSG msg ； 

WNDCLASSEX wcl; 

INITCOMMONCONTROLSEX cc; 


// 창문믈라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) : 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0 ； // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ； // 큰 아이콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC 一 ARROW); // 유표의 형식 
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wcl. IpszMenuName = NULL ； // 믈라스차림표는 없다 . 
wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) : 

// 창문콜라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문클라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Using a Tab Control", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CW_USEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

)； 


// 공통조종체를 초기 화한다 . 

cc.dwSize = sizeof (INITCOMMONCONTROLSEX) ; 
cc.dwICC = ICC_TAB_CLASSES | ICC_UPDOWN_CLASS : 
InitCommonControlsEx (&cc) : 


hlnst = hThisInst ； 현재실체손잡이를 보관한다 . 

// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode) : 
UpdateWindow (hwnd) : 

// 통보문순환고리를 작성 한다 . 
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while (GetMessage (&msg, NULL, 0, 0)) 

{ 

if (! hDlg 11 ! IsDialogMessage (hDlg, &msg)) { 
TranslateMessage(&msg) ； // 건반통보률 변환한다 . 
DispatchMessage(&msg) ； // Windows 2000 에 조종을 넘 긴다 . 

} 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

NMHDR *nmptr; 
int tabnumber = 0 ； 

TCITEM tci ； 

switch (message) { 
case WM_CREATE ： 
hTabWnd = CreateWindow( 

WC_TABCONTROL, 

WS_VISIBLE | WS—TABSTOP | WS.CHILD, 

20, 20, 368, 246, 
hwnd, 

NULL, 

hlnst, 

NULL 

)； 


tci. mask = TCIF.TEXT ； 
tci. ilmage = -1 ； 

tci. pszText = TabName[0] ； 
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TabCtrlJnsertltem (hTabWnd, 0, &tci) ； 

tci. pszText = TabName [1] ； 

TabCtrlJnsertltem (hTabWnd, 1, &tci) ； 

tci. pszText = TabName [2] ； 

TabCtrlJnsertltem (hTabWnd, 2, &tci) ； 

hDlg = CreateDialog(hInst, ” TabDBl", hTabWnd, 

(DLGPROC) DialogFuncl); 

break ； 

case WM.NOTIFY ： 
nmptr = (LPNMHDR) IParam; 
if(nmptr->code == TCN_SELCHANGE) { 
if (hDlg) Destroy Window (hDlg) ； 

tabnumber = TabCtrl_GetCurSel ((HWND) nmptr->hwndFrom) ； 
switch (tabnumber) { 
case 0 ： 

hDlg = CreateDialog(hInst, "TabDBl”, 

hTabWnd, (DLGPROC) DialogFuncl) ； 

break ； 
case 1 ： 

hDlg = CreateDialog(hInst, "TabDB2 n , 

hTabWnd, (DLGPROC) DialogFunc2) ； 

break ； 
case 2 ： 

hDlg = CreateDialog(hInst, "TabDB3”, 

hTabWnd, (DLGPROC) DialogFunc3) ； 

break ； 

} 

} 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 
if (hDlg) Destroy Window (hDlg) ； 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
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Windows 2000 에 처 리 률 맡긴 다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 

} 

return 0 ； 

} 

// 「 Options 」 의 대화함수 

BOOL CALLBACK DialogFuncl (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

static long udpos = 0; 
static char str[80] ； 
static HWND hEboxWnd ； 
static HWND udWnd ； 
static statusCBl, statusCB2 ； 
static statusRBl ； 
int low=0, high=10 ； 


switch (message) { 
case WMJNITDIALOG ： 

InitStatus(hdwnd) ； // 상태 창문을 초기 화한다 . 

hEboxWnd = GetDlgltem (hdwnd, ID_EB1) ； 
udWnd = CreateUpDownControl ( 

WS 一 CHILD | WS—BORDER | WS.VISIBLE | 
UDS_SETBUDDYINT | UDS.ALIGNRIGHT, 
10, 10, 50, 50, 
hdwnd, 

ID.UPDOWN, 

hlnst, 

hEboxWnd, 
high, low, high/2) ； 

// 단일선택단추를 초기화한다 . 

SendDlgltemMessage (hdwnd, ID_RB2, BM_SETCHECK, 
BST.CHECKED, 0); 

return 1; 

case WM.VSCROLL ： // 오르내 리기조종체 를 초기화한다 . 
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if (udWnd== (HWND) IParam) { 
udpos = GetDlgItemInt(hdwnd, ID_EB1, NULL, 1) ； 
sprintf(str, "Power ： %d”, udpos) ； 

SendMessage (hStatusWnd, SB_SETTEXT, 

(WPARAM) 0, (LPARAM) str) ； 

} 

return 1 ； 

case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case ID_CB1: // 「 Optimize 」 검사칸을 처 리 한다 . 
statusCBl = SendDlgltemMessage (hdwnd, ID_CB1, 
BM.GETCHECK, 0, 0); 
if (statusCBl) sprintf (str, "Optimize ： Yes’’); 
else sprintf(str, "Optimize ： No"); 

SendMessage (hStatusWnd, SB_SETTEXT, 
(WPARAM) 1, (LPARAM) str )； 

return 1 ； 

case ID_CB2 ： // 「 Debug 」 검사칸을 처 러 한다 . 
statusCB2 = SendDlgltemMessage(hdwnd, ID_CB2, 
BM.GETCHECK, 0, 0); 
if(statusCB2) sprintf (str, ” Debug: Yes”); 
else sprintf (str, ” Debug: No’’); 

SendMessage (hStatusWnd, SB_SETTEXT, 
(WPARAM) 2, (LPARAM) str )； 

return 1; 

case ID_CB3 ： //「NT 4 」검사칸을 처 리 한다 . 
statusCB2 = SendDlgltemMessage (hdwnd, ID_CB3, 
BM.GETCHECK, 0, 0); 
if (statusCB2) sprintf (str, "NT 4: Yes") ； 
else sprintf (str, "NT 4 ： No"); 

SendMessage (hStatusWnd, SB_SETTEXT, 
(WPARAM) 3, (LPARAM) str )； 

return 1; 

case ID.RBl: // 단일선택 단추를 처 리한다 . 
case ID_RB2 ： 

statusRBl = SendDlgltemMessage (hdwnd, ID_RB1, 
BM.GETCHECK, 0, 0); 
if (statusRBl) sprintf (str, "Using C") ； 
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else sprintf (str, "Using C++") : 

SendMessage (hStatusWnd, SB_SETTEXT, 

(WPARAM) 4, (LPARAM) stir); 


return 1; 

case ID_RESET ： // 추가선택항목을 재설정한다 . 

SendMessage (udWnd, UDM_SETPOS, 0, (LPARAM) high/2); 
SendMessage ChStatusWnd, SB_SETTEXT, (WPARAM) 0, 
(LPARAM) "Power ： 5 ")； 

SendDlgltemMessage (hdwnd, ID_CB1, 

BM_SETCHECK, 0, 0 )； 

SendDlgltemMessage (hdwnd, ID_CB2, 

BM_SETCHECK, 0, 0); 

SendDlgltemMessage (hdwnd, ID_CB3, 

BM_SETCHECK, 0, 0); 

SendMessage (hStatusWnd, SB_SETTEXT, (WPARAM) 1 ， 
(LPARAM) "Optimize ： No") : 

SendMessage(hStatusWnd, SB_SETTEXT, (WPARAM) 2, 
(LPARAM) "Debug ： No") : 

SendMessage (hStatusWnd, SB_SETTEXT, (WPARAM) 3, 
(LPARAM) "NT 4 ： No"); 

SendMessage (hStatusWnd, SB_SETTEXT, (WPARAM) 4, 
(LPARAM) "Using C++") : 
return 1 ； 
case IDCANCEL ： 
case IDOK ： 

PostQuitMessage (0) : 
return 1 ； 


// 두번째 대화함수 (허위적인것 ) 

BOOL CALLBACK DialogFunc2 (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

switch (message) { 


414 


case WM_COMMAND ： 


교육성 프로그람교육쎈터 



제 12 장. 상태창문，표쪽조종체 및 나무구조보기조종체 


switch (LOWORD (wParam)) { 
case IDCANCEL ： 
case IDOK ： 

PostQuitMessage (0) ； 
return 1 ； 

} 

} 

return 0 ； 

} 

// 세번째 대화함수 ( 허위적인것 ) 

BOOL CALLBACK DialogFunc3 (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

switch (message) { 
case WM_COMMAND ： 
switch (LOWORD (wParam)) { 
case IDCANCEL ： 
case IDOK ： 

PostQuitMessage (0) : 
return 1 ； 

} 

} 

return 0 ； 

} 

// 상래창문의 초기화 

void InitStatusCHWND hwnd) 

{ 

RECT WinDim ； 
int i ； 


GetClientRect (hwnd, &WinDim); 


for(i=l; i<=NUMPARTS; i++) 
parts[i-1] = WinDim.right/NUMPARTS * i ； 


// 상태 창문을 작성 한다 . 
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hStatusWnd = CreateStatusWindow ( 

WS.CHILD | WS_VISIBLE, 

"Power ： 5”, hwnd, 

ID_STATUSWIN) ； 

SendMessage (hStatusWnd, SB.SETPARTS, 

(WPARAM) NUMPARTS, (LPARAM) parts) ； 


SendMessage (hStatusWnd, SB_SETTEXT, 
(LPARAM) "Optimize: No"); 
SendMessage (hStatusWnd, SB_SETTEXT, 
(LPARAM) ” Debug: No，，); 
SendMessage (hStatusWnd, SB.SETTEXT, 
(LPARAM) "NT 4 ： No") ； 
SendMessage (hStatusWnd, SB_SETTEXT, 
(LPARAM) "Using C++") ； 


(WPARAM) 1, 
(WPARAM) 2, 
(WPARAM) 3, 
(WPARAM) 4, 


이 프로그람에는 아래의 자원이 필요하다. 경계선이 없는 대화칸이라는 점에 주의를 
돌려야 한다. 


#include < windows. h> 
ttinclude "tab.h" 

TabDBl DIALOGEX 2, 16, 180, 92 
STYLE WS.CHILD | WS.VISIBLE 
{ 

PUSHBUTTON ” Reset”, ID.RESET, 112, 40, 37, 14 
PUSHBUTTON M OK M , IDOK, 112, 60, 37, 14 
EDITTEXT ID_EB1, 10, 10, 20, 12, ES_LEFT | 

WS_TABSTOP | WS.BORDER 
LTEXT "Power Factor”, ID.STEXTl, 36, 12, 50, 12 
AUTOCHECKBOX "Optimize", ID_CB1, 10, 35, 48, 12 
AUTOCHECKBOX "Debug Info’，, ID_CB2, 10, 50, 48, 12 
AUTOCHECKBOX "NT 4 Compatible", ID_CB3, 10, 65, 70, 12 
AUTORADIOBUTTON "C", ID_RB1, 112, 8, 20, 12 
AUTORADIOBUTTON "C++”, ID.RB2, 112, 20, 28, 12 
LTEXT "Language", ID.STEXT2, 140, 14, 40, 12 


416 


교육성 프로그람교육쎈터 



제 12 장. 상태창문，표쪽조종체 및 나무구조보기조종체 


TabDB2 DIALOGEX 2, 16, 180, 92 
STYLE WS.CHILD | WS.VISIBLE 
{ 

PUSHBUTTON ”OK n , IDOK, 82, 43, 37, 14 
PUSHBUTTON ’’CANCEL”, IDCANCEL, 132, 43, 37, 14 
LTEXT "Show contents of”, ID.STEXT3, 10, 10, 60, 12 
AUTORADIOBUTTON "Registers”, ID.RB3, 10, 30, 48, 12 
AUTORADIOBUTTON "Variables”, ID_RB4, 10, 50, 52, 12 
AUTORADIOBUTTON ” Stack”, ID_RB5, 10, 70, 48, 12 

} 

TabDB3 DIALOGEX 2, 16, 180, 92 
STYLE WS.CHILD | WS.VISIBLE 
{ 

PUSHBUTTON M OK M , IDOK, 82, 43, 37, 14 
PUSHBUTTON ” CANCEL”, IDCANCEL, 132, 43, 37, 14 
LTEXT "Report", ID.STEXT4, 10, 10, 60, 12 
AUTOCHECKBOX "Syntax errors", ID_CB4, 10, 30, 60, 12 
AUTOCHECKBOX "Warnings”, ID_CB5, 10, 50, 60, 12 
AUTOCHECKBOX "ANSI Violations' ID_CB6, 10, 70, 70, 12 

} 

머리부파일 TAB.H 의 내용을 아래에 보여 주었다. 

ttdefine IDM_DIALOG 100 

#define IDM.EXIT 101 

Mefine IDM.HELP 102 

ttdefine ID.UPDOWN 103 

#define ID_EB1 104 

Mefine ID_EB2 105 

Mefine ID_CB1 106 

#define ID_CB2 107 

Mefine ID_CB3 108 

Mefine ID_CB4 109 

#define ID_CB5 110 

Mefine ID.CB6 111 
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#define ID.RB1 112 

ttdefine ID.RB2 113 

ttdefine ID.RB3 114 

#define ID.RB4 115 

ttdefine ID.RB5 116 

ttdefine ID.RESET 117 

ttdefine ID.STATUSWIN 200 

#define ID.STEXTl 300 

#define ID.STEXT2 301 

ttdefine ID.STEXT3 302 

#define ID_STEXT4 303 



그림 12-3. 표쪽조종제의 두번째 실례프로그람의 실행결과 

이 프로그람에서 특히 주목해야 할 부분은 WindowsFunc ( ) 에서 WM.NOTIFY 통 
보문을 처 리 하는 case 문이 다. 아래 에 다시 그 부분의 프로그람코드를 보여 주었 다. 

case WM.NOTIFY ： 

nmptr = (LPNMHDR) IParam; 
if(nmptr->code == TCN.SELCHANGE) { 
if(hDlg) Destroy Window (hDlg) ； 

tabnumber = TabCtrl_GetCurSel ((HWND) nmptr->hwndFrom) ； 
switch (tabnumber) { 
case 0 ： 

hDlg = CreateDialog(hInst, "TabDBl”, 

hTabWnd, (DLGPROC) DialogFuncl) ； 
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break ； 
case 1 ： 

hDlg = CreateDialog(hInst, ” TabDB2 n , 

hTabWnd, (DLGPROC) DialogFunc2) ； 

break ； 
case 2 ： 

hDlg = CreateDialog(hInst, ” TabDB3 n , 

hTabWnd, (DLGPROC) DialogFunc3) ； 

break ； 

} 

} 

break ； 


새로운 표쪽이 선택되였을 때 두가지 처리가 진행된다. 우선 Destroy Window ( )를 
사용하여 현재 선택되 여 있는 표쪽에 련관된 대 화칸을 삭제 한다. (비양식 화대 화칸을 닫으 
려면 양식화대화칸에서 사용되는 EndDialog ( ) 가 아니라 Destroy Window ( )를 사용하 
여야 한다.) 

다음 선택된 표쪽을 얻고 그 표쪽에 련관된 대화칸을 CreateDialogC ) 를 사용하여 작 
성 한다. (비 양식 화대 화칸을 작성 하는데 CreateDialog ( ) 를 사용한다. ) 이 처 리 순서 를 자체 
로 작성 하는 응용프로그람에서 표쪽조종체와 대화칸을 련관시 킬 때도 사용할수 있다. 

더 나가기에 앞서 이 프로그람을 가지고 여러가지 실험을 해보는것이 유익하다. 례 
하면 대 화칸이 나 표쪽조종체 를 변경 해 보시 오. 표쪽조종체 에 도구설 명쪽지 를 추가할수도 
있 다. 

나무구조보기조종체 


나무구조보기조종제 {Tree View Control ) 는 나무구조로 정보를 표시하는데 사용된다. 
례를 들어 Windows 2000 의 람색프로그람 (Internet Explorer ) 에서는 등록부의 목록을 
나무구조보기조종체를 사용하여 표시 하고 있다. 나무는 계층구조로 되여 있으므로 계층 
적 인 정 보를 표시 하는 경 우에 만 나무구조보기 조종체 를 사용해 야 한다. 나무구조보기 조종 
체는 매우 강력하며 많은 추가선택기능들을 제공하고 있다. 나무구조보기조종체에 대한 
설명만으로도 한권의 책 이 될것 이 다. 

그러 므로 여기 에서는 나무구조보기조종체 의 기본적 인 사용방법 에 대 해서만 설명 
하기 로 한다. 본질 을 알면 자체 로 나무구조보기 조종체 에 여 러 가지 기 능들을 추가할 
수 있다. 
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나무구조보기조종체의 작성 

나무구조보기조종체는 쪠7次公 SF / 표，콜라스를 지정하고 CreateWindow ( ) 또는 
CreateWindowEx ( )를 사용하여 작성하는 창문이다. 나무구조보기조종체는 새끼창문이 
므로 WS _ CUILD 형색도 지정해야 한다. 

일반적으로 나무구조보기조종체가 자동적 으로 표시되게 하기 위해 WS_YISIBLE 형 
식 도 지 정 한다. WS _ TABSTOP 형 식 도 지 정 해 야 한다. 나무구조보기 조종체 에 는 나무와 
관련된 형식을 몇가지 지정할수 있다. 아래에 형식의 종류를 보여 주었다. 


TVS—HASLINES 

나무가지 에 선을 표시한다. 

TVS LINESATROOT 

뿌리와 가지를 련결하는 선을 표시한다. 

TVS_HASBUTTONS 

매 가지 의 왼쪽에 전개 /접 기단추를 표시한다. 


형 식 과 TVS_LINESATROOT 형 삭 을 포함시 켜 나무의 매 항목에 로 
뻗는 직선을 표시할수 있다. 이 렇게 하면 나무구조보기조종체 가 실지 나무 같은 모양을 
가지게 된다. 

TVS_HASBUTTONS 를 포함시 키 면 표준적 인 전개 /접 기 단추가 추가된 다. 가지 를 한 
단계 이 상 전개할수 있는 경 우에는 단추에 +표식 이 표시된다. 이 단추를 마우스로 누르면 
가지 를 전개하거 나 접 을수 있 다. 

나무구조보기조종체를 작성할 때는 이 세개의 형식을 모두 포함시키는것이 일반적이 
다. 표준적 인 나무구조보기조종체 를 작성 하기 위한 프로그람코드의 례 를 아래 에 보여 주 
었 다. 


hTreeWndCtrl = CreateWindow ( 

WC_TREEVIEW, 


WS_VISIBLE | WS_TABSTOP | WS_CHILD | 
TVS_HASLINES | TVS_HASBUTTONS | 
TVS.LINESATROOT, 

0 , 0 , 100 , 100 , 
hwnd, // 어미손잡이 
NULL, 

hlnst, // 실체손잡이 
NULL 
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나무구조보기조종체를 작성한 직후에는 그 내용이 비여 있다. 나무에 항목을 추가하 
는 방법 은 다음에 설 명한다. 

나무구조보기 조종체에 를보문들 보내기 

나무구조보기 조종체 에 몇 가지 통보문을 보낼수 있다. 나무구조보기조종체의 주요한 
통보문들을 표 12-3 에 보여 주었 다. 통보문을 보내 기 위 해 SendMessageO 를 사용하든 
가 전용마크로를 사용한다. 다음에 보여 준 나무구조보기조종체용마크로들은 표 12-3 에 
보여 준 통보문들을 보내는 기능을 수행한다. 이 모든 마크로들에 있어서 hTreeWnd 에 
는 나무구조보기조종체의 손잡이를 설정한다. 

BOOL TreeView_DeleteItem ( , HTREEITEM hltem ) 

BOOL TreeView _ Expand(HWND hTreeWnd , HTREEITEM hltem , 

UINT action ) 

BOOL TreeView_GetItem (TVITEM * lpltem ) 


HTREEVIEW TreeViewJnsertltem(HWND hTreeWnd , 

TVINSERTSTRUCT * lpltem ) 


BOOL TreeView_Select (HWND hTreeWnd , HTREEITEM hltem , 

UINT action ) 

이 장 의 실 례 프 로 그 람 에 서 사 용 되 는 통 보 문 들 은 TVMJNSERTITEM 과 
TVM_EXPAND 이 다 . 


나무구조보기 조종체 의 주요한 통보문 


TVM_DELETEITEM 


나무목록에 서 항목을 삭제한다. 호출이 성 공하면 령 
아닌 값을 돌려 주고 실패하면 령 을 돌려 준다. 
wParam 에 는 령 을 설 정 한다. lParam 에 는 삭제 할 항목 
의 손잡이를 설정한다. 
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TVM—EXPAND 

나무목록을 한 단계 전개하거나 접는다. 호출이 성공 
하면 령 아닌 값을 돌려 주고 실패하면 령 을 돌려 준 
다. wParam 에 는 조작내 용을 설정한다. 이 값은 
TVE—COLLAPSE (나무를 접기)， TVE—COLLAPSE 
RESET (나무를 접 고 새 끼항목을 삭제한다.), TVE _ 
EXPAND ( 나 무 를 전 개 한 다 .), TVE_EXPAND 
PARTIAL (나무를 부분적 으로 전개한다. ) 또는 TVE _ 
TOGGLE (상태를 반전절환하여 변경한다.)의 어느 하 
나 여 야 한 다 . TVE_COLLAPERESET 는 TVE _ 
COLLAPSE 와 함 께 사 용 되 여 야 한 다 . TVE _ 
EXPANDPARTIAL 은 TVE_EXPAND 와 함께 사용되 
여 야 한다. IParam 에는 가지 어미의 손잡이를 설정한다. 

TVM—GETITEM 

항목의 속성을 얻는다. 호출이 성공하면 령 아닌 값 
을 돌려 주고 실패하면 령을 돌려 준다. wParam 에는 
령을 설정 한다. IParam 에는 항목의 정보를 보관하기 
위 한 TVITEM 구조체 의 지 시 자를 설정 한다. 

TVMJNSERTITEM 

나무에 항목을 삽입한다. 호출이 성 공하면 삽입된 
항목의 손잡이 를 돌려 주고 실패하면 NULL 을 돌려 
준다. wParam 에 는 령 을 설정 한다. IParam 에 는 항목 
의 정 보를 보관하기 위 한 TVINSERTSTRUCT 구조체 
의 지 시 자를 설 정한다. 

TVM_SELECTITEM 

나무구조보기 의 항목을 선택한다. 호출이 성 공하면 
령 아닌 값이 돌려 주고 실패하면 령 을 돌려 준다. 
wParam 에 는 조 작 내 용 을 설 정 한 다 . 이 값 이 
TVGN_CARET 인 경 우는 항목이 선택 된 다. 
TVGN_DROPHILITE 인 경 우는 끌어 다놓기 (Drag and 
drop ) 를 위 해 항 목 이 강 조 표 시 된 다 . TVGN _ 
FIRSTVISIBLE 인 경우는 지정된 항목이 제일 우에 
표시되게 나무구조보기가 흘리기된다. IParam 에는 항 
목의 손잡이를 설정한다. 


항목을 삽입 할 때 는 아래 에 보여 준 TVINSERTSTRUCT 구3색 예 항목의 정 보를 
보관한다. 


typedef struct tagTVINSERTSTRUCT { 
HTREEITEM hParent ； 

HTREEITEM hlnsertAfter ； 
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union { 

TVITEMEX item ； 
TVITEM item ； 

} 

} TVINSERTSTRUCT ； 


hParent 는 항목에 있는 어미의 손잡이 이다. 항목에 어미가 없는 경우는 여기에 
TVLROOT 를 설정 한다. hlnsertAfter 의 값은 새 로운 항목을 나무에 삽입 하는 방법 을 
지정한다. 여기에 항목의 손잡이를 설정하면 그 항목의 밑에 새로운 항목이 삽입된다. 
그렇지 않은 경우에는 hlnsertAfter 에 아래의 어느 한 값을 설정한다. 


TVI—FIRST 

목록의 선두에 삽입한다. 

TVI—LAST 

목록의 끝에 삽입한다. 

TVI ROOT 

뿌리에 삽입한다. 

TVI—SORT 

자모순으로 삽입한다. 


item 에 항목의 내 용을 설정 한다. 이 성 원은 TVITEM 또는 TVITEMEX 구조체 여 야 
한다. TVITEMEX 는 TVITEM 의 확장판이 고 이 장의 실 례 프로그람에 서 는 사용되 지 않 
는 몇가지 특수한 기능을 제공한다. 구조체의 정의를 아래에 보여 주었다. 


typedef struct tagTVITEM { 

UINT mask ； 

HTREEITEM hltem ； 

UINT state; 

UINT stateMask ； 

LPSTR pszText ； 
int cchTextMax; 
int ilmage ； 
int iSelectedlmage ； 
int cChildren ； 

LPARAM IParam; 

} TVITEM ； 

mask 의 값은 TVITEM 구조체에 나무구조보기조종체의 정보가 보관되였을 때 어느 
성원에 유효한 값이 보관되여 있는가를 가러킨다. mask 의 값은 아래의 값들의 조합으로 
된 다. 
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TVIF—HANDLE 

hltem 에 자료가 보관되 여 있 다. 

TVIF—STATE 

state 와 stateMask 에 자료가 보관되 여 있 다. 

TVIF—TEXT 

pszText 와 cchTextMax 에 자료가 보관되 여 
있 다. 

TVIFJMAGE 

ilmage 에 자료가 보관되 여 있 다. 

TVIF—SELECTEDIMAGE 

iSelectedlmage 에 자료가 보관되 여 있 다. 

TVIF CHILDREN 

cChildren 에 자료가 보관되 여 있 다. 

TVIF—PARAM 

lParam 에 자료가 보관되 여 있 다. 


hltem 에 는 항목의 손잡이 를 설정 한다. 

state 에는 나무구조보기조종체의 상태를 설정한다. 나무구조보기조종체의 주요한 상 
태들을 아래에 보여 주었다. 


TVIS—DROPHILITED 

끌어다놓기의 목적지로서 항목이 강조표 
시되여 있다. 

TVIS—EXPANDED 

항목이하의 가지 가 모두 전개되 여 있 
다. (어 미항목에 만 적 용된 다. ) 

TVIS_EXPANDEDONCE 

항목이하의 가지 가 한단계(혹은 그이상) 
전개 되 여 있 다. (어 미항목에만 적 용된 다. ) 

TVIS—EXPANDEDPARTIAL 

항목이하의 가지 가 부분적 으로 전개 되 여 
있 다. 

TVIS SELECTED 

항목이 선택되여 있다. 


stateMask 에는 상태를 설정하거나 얻으러는 항목을 지정한다. 여기에는 앞에서 보 
여 준 한개이상의 값을 지정한다. 

항목을 나무에 삽입할 때는 pszText 에 나무에 표시될 문자렬의 지시자를 설정한다. 
항목의 정보를 엄을 때는 본문을 보관하기 위한 배렬의 지시자를 pszText 에 설정한다. 
이 경우에는 cchTextMax 에 pszText 에서 가리키는 배 럴의 크기를 설정 한다. 이 밖의 
경우에 cchTextMax 는 무시된다. 

나무구조보기조종체에 화상목록을 련관시키는 경우에는 항목이 선택되여 있지 않을 
때 사용되는 화상의 색인을 ilmage 에 설정한다. 항목이 선택되여 있을 때 사용되는 화 
상의 색 인은 ilmageSelected 에 설정 한다. (이 장에서 작성 하는 나무구조보기조종체 에서 
는 화상을 사용하지 않는다.) 

항목이 새끼 항목을 가지 는 경 우에 는 cChildren 에 1 을 설정 한다. 그렇 지 않은 경 우 
에는 령을 설정한다. lParam 에는 응용프로그람자체의 자료를 설정 할수 있다. 
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나무구조보기조종체의 를 지문 

나무구조보기 조종체 가 조작되 면 WM_NOTIFY 통보문이 생 성 된 다. 나무구조보기 조 
종체와 관련된 통지문들이 몇 종류 있다. 잘 사용되는 통지문들을 아래에 보여 주었다. 




TVN—DELETEITEM 

항목이 삭제되였다. 

TVNJTEMEXPANDING 

가지가 전개되거나 접히려고 하고 있다. 

TVNJTEMEXPANDED 

가지가 전개되거나 접히였다. 

TVN—SELCHANGING 

새로운 항목이 선택되려고 하고 있다. 

TVN_SELCHANGED 

새로운 항목이 선택되였다. 



이 통지문들을 엄으려면 WM_NOTIFY 통보문을 보냈을 때 IParam 에 보관되여 있 
는 NMTREEVffiW 구조체의 지시자를 참조한다. NMTREEVEW 구조체의 정의를 아래 
에 보여 주었다. 


typedef struct tagNMTREEVIEW { 
NMHDR hdr ； 


UINT action ； 

TVITEM ； 

TVITEM itemNew ； 

POINT ptDrag ； 

} NMTREEVIEW ； 

NMTREEVIEW 구조체의 첫 성원은 NMHDR 구조체로 되여 있 다. 통지문은 
hdr. code 에 보관된다. 그리고 통보문을 생성 한 나무구조보기 조종체의 손잡이는 
hdr.hwndFrom 에 보관된 다. 

ac 社 on 에 는 통지 문과 관련된 정 보가 보관된다. itemOld 및 itemNew 에 는 마지 막으 
로 선택되여 있던 항목(만일 있다면)의 정보 또는 새로 선택된 항목(만일 있다면)의 정 
보가 보관된다. 통보문이 생성되였을 때의 마우스의 위 치가 ptDrag 에 보관된다. 

TVN_ 況 : LCHANGING 파 TVN_ 況 : LCHANGED 예사 는 itemOld 에 마지 막으로 선택되 
여 있던 항목이 보관되고 itemNew 에는 새롭게 선택된 항목이 보관된다. 
TVN—ITEMEXPANDING 파 TVN_ITEMEXPANDED 아 사 는 itemNew 에 전개 되는 가지의 
어 미 항목 이 보관된 다. TWNL 必5己5：7五7刀^改1/에 서 는 itemOld 에 삭제 된 항목이 보관된 다. 

이식과 관련한 요점 : 나무구조보기조종체와 관련한 구조체들의 이름은 새롭게 변경되였다. 
아래의 표에 이 장에서 사용되고 있는 구조체들의 낡은 이름과 새 이름의 대응관계를 보 
여 주었다. 낡은 프로그람을 이식하는 경우에는 새로운 이름의 구조체를 사용해야 한다. 
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새로년 


TV_ITEM 

TVITEM 

TVJNSERTSTRUCT 

TVINSERTSTRUCT 

NM.TREEVIEW 

NMTREEVIEW 

NM_DISPINFO 

NMTVDISPINFO 


나무구조보기 조종체의 실례 프로그람 

실례 12-4 의 프로그람은 나무구조보기조종체의 실례 프로그람이 다. 이 프로그람에서 
는 간단한 나무를 작성하고 가지의 전개와 나무전체의 전개 및 가지의 접기를 할수 있다. 
나무구조보기조종체에서 새로운 항목이 선택되면 그 내용이 창문에 표시된다. 프로그람 
의 실행결과를 그림 12-4 에 보여 주었 다. 

실례 12-4. Tree 프로그람 
// 나무구조보기조종체의 실례 

ttinclude < windows. h> 
ttinclude <commctrl.h> 
include "tree, h" 

ttdefine NUM 6 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 

BOOL CALLBACK DialogFunc(HWND, UINT, WPARAM, LPARAM) ； 

void InitTree(void) ； 

void report (HDC hdc, char *s); 

char szWinName[] = n MyWin，，; // 창문믈라스의 이름 


HINSTANCE hlnst ； 

HWND hwnd ； 

HWND hTreeWndCtrl ； 
HTREEITEM hTreeWnd [NUM] ； 
HTREEITEM hTreeCurrent ； 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 


LPSTR IpszArgs, int nWinMode) 
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MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 
INITCOMMONCONTROLSEX cc ； 

// 창문물라스를 정의 한다 . 

wcl. cbSize = sizeof (WNDCLASSEX) : 


wcl.hlnstance = hThisInst; // 실체의 손잡이 

wcl. li 犯 zClassName = szWinName ； // 창문믈라스의 이름 

wcl. lpfnWndProc = WindowFunc ； // 창문함수 

wcl.style = 0; // 체계 설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이콘 

wcl. hlconSm = NULL ； // 큰 아이론의 축소판을 사용한다 . 

wcl. hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl. IpszMenuName = "TreeViewMenu" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject (WHITE_BRUSH) ; 

// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Using a Tree-View Control", // 제목 
WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Wtadows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 너비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 
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hThisInst, // 실체의 손잡이 
NULL // 추가파라메터는 없 다 . 

)； 

hlnst = hThisInst ； // 현재실체의 손잡이를 보관한다 . 

// 건반가속기를 적재한다 . 

hAccel = LoadAccelerators (hThisInst, "TreeViewMenu") : 
// 공통조종체를 초기화한다 . 

cc.dwSize = sizeof (INITCOMMONCONTROLSEX) ; 
cc.dwICC = ICC_TREEVIEW_CLASSES : 
InitCommonControlsEx (&cc) : 


// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while(GetMessage(&msg, NULL, 0, 0)) 

{ 

if(! TranslateAccelerator(hwnd, hAccel, 技 msg)) { 
TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage(Smsg) ; // Windows 2000 에 조종을 넘 긴다 . 

} 

} 

return msg. wParam ； 

} 


/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 

static char selection[80] = ""； 


428 


교육성 프로그람교육쎈터 



제 12 장. 상태창문，표쪽조종체 및 나무구조보기조종체 


NMTREEVIEW *nmptr ； 
PAINTSTRUCT paintstruct ； 
int i, response ； 

RECT WinDim ； 

switch (message) { 
case WM.CREATE ： 

// 어미창문의 크기를 엄는다 . 
GetClientRect (hwnd, &WinDim); 

// 나무구조보기조종체를 작성한다 . 
hTreeWndCtrl = CreateWindow( 


WC.TREEVIEW, 

WS.VISIBLE | WS_TABSTOP | WS.CHILD | 
TVSJHASLINES | TVS.HASBUTTONS | 
TVS.LINESATROOT, 

0 , 0 , 200 , 200 , 

hwnd, 

NULL, 

hlnst, 

NULL 

); 


InitTreeC ) ； 
break ； 

case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM_EXPAND ： 

TreeView.Expand(hTreeWndCtrl, hTreeCurrent, 


TVE.EXPAND) ； 


break ； 



TreeView_Expand (hTreeWndCtrl, hTreeWnd [i], 


TVE_EXPAND); 


break ； 

case IDM_COLLAPSE : 
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TreeView_Expand(hTreeWndCtrl, hTreeCurrent, 
TVE.COLLAPSE) ； 

break； 

case IDM.EXIT： 

response = MessageBox(hwnd, "Quit the Program?”, 
” Exit”, MB_YESNO) ； 
if (response == ID YES) PostQuitMessage(O); 
break； 

case IDM_HELP: 

MessageBox(hwnd, "Try the Tree View", 

"Help，，, MB_OK) ； 

break； 

} 

break； 

case WM.NOTIFY： 
nmptr = (LPNMTREEVIEW) IParam； 
if(nmptr->hdr.code == TVN.SELCHANGED) { 
InvalidateRect (hwnd, NULL, 1); 
if (nmptr->itemNew. hltem == hTreeWnd [0]) 
strcpy (selection, "Physics.") ; 
else if(nmptr->itemNew. hltem == hTreeWnd [1]) 
strcpy (selection, "Mechanics.") ； 
else if(nmptr->itemNew. hltem == hTreeWnd [2]) 
strcpy (selection, "Electricity. ”) ; 
else if(nmptr->itemNew. hltem == hTreeWnd [3]) 
strcpy (selection, "Momentum. ”); 
else if (nmptr->itemNew. hltem == hTreeWnd [4]) 
strcpy (selection, "Linear Momentum.") ； 
else if (nmptr->itemNew. hltem == hTreeWnd [5]) 
strcpy (selection, "Angular Momentum.”); 

hTreeCurrent = nmptr->itemNew. hltem； 

} 

break； 

case WM_PAINT： 

hdc = BeginPaint (hwnd, &paintstruct) : 
report (hdc, selection) ； 

EndPaint (hwnd, &paintstruct) ； 
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break； 

case WM.DESTROY： II 프로그람을 끝낸다. 

PostQuitMessage (0) ； 
break； 
default： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리 률 맡긴 다. */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 

} 

return 0； 

} 

// 선택된 항목을 표시한다. 
void report (HDC hdc, char *s) 

{ 

char str[80] ； 


if(*s) { 

strcpy(str, "Selection is "); 
strcat(str, s)； 

} 

else strcpy(str, "No selection has been made."); 
TextOut(hdc, 0, 200, str, strlen(str)) ； 


// 나무의 목록을 초기화한다. 
void InitTree(void) 

{ 

TVINSERTSTRUCT tvs； 

TVITEM tvi； 

tvs. hlnsertAfter = TVI_LAST； // 추가된 순서로 항목들을 배 렬한다. 
tvi. mask = TVIF.TEXT； 


tvi. pszText = ’’Physics"; 
tvs.hParent = TVI.ROOT； 
tvs. item = tvi； 

hTreeWnd [0] = TreeView_InsertItem (hTreeWndCtrl, &tvs) ； 
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hTreeCurrent = hTreeWnd[0] ； 

tvi. pszText = "Mechanics" ； 
tvs. hParent = hTreeWnd[0] ； 
tvs. item = tvi; 

hTreeWnd[l] = TreeView_InsertItem (hTreeWndCtrl, 射 vs); 

tvi. pszText = "Electricity" ； 
tvs. item = tvi； 

tvs. hParent = hTreeWnd[0]; 

hTreeWnd [2] = TreeView_InsertItem (hTreeWndCtrl, &tvs) ； 


tvi. pszText = ” Momentum”; 
tvs. item = tvi; 

tvs. hParent = hTreeWnd[1] ； 

hTreeWnd[3] = TreeView_InsertItem(hTreeWndCtrl, 射; vs); 


tvi. pszText = ’’Linear"; 
tvs. item = tvi； 

tvs. hParent = hTreeWnd[3] ； 

hTreeWnd [4] = TreeView_InsertItem (hTreeWndCtrl, 射 vs); 

tvi. pszText = "Angular" ； 
tvs. item = tvi； 

tvs. hParent = hTreeWnd[3] ； 

hTreeWnd [5] = TreeView_InsertItem (hTreeWndCtrl, &tvs) ； 

} 


이 프로그람은 아래의 자원파일을 필요로 한다. 

#include < windows. h> 

^include "tree. h M 

TreeViewMenu MENU 

{ 

POPUP M &Options" { 

MENUITEM '^Expand One\tF2”, IDM.EXPAND 
MENUITEM ” Expand &All\tF3”, IDM.EXPANDALL 
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MENUITEM ” &Collapse\tF4", IDM.COLLAPSE 
MENUITEM ” E&xit\tCtrl+X", IDM—EXIT 

} 

MENUITEM "&Help M , IDM.HELP 


TreeViewMenu ACCELERATORS 

{ 

VK_F1, IDM_HELP, VIRTKEY 
VK_F2, IDM_EXPAND, VIRTKEY 
VK_F3, IDM_EXPANDALL, VIRTKEY 
VK_F4, IDM—COLLAPSE, VIRTKEY 
『 X", IDM_EXIT 

} 

머리부파일 TREE . H 의 내용을 아래에 보여 주었다. 


#define IDM_EXPAND 100 

Mefine IDM.EXPANDALL 101 

#define IDM_COLLAPSE 102 

#define IDM.EXIT 103 

Mefine IDM.HELP 104 


—prriT『? 



그림 12-4. 나무구조보기 조종제 프로그람의 실행 결과 
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이 프로그람에서는 InitTreeC ) 라는 함수에서 나무구조보기조종체를 초기 화하고 있 
다. 매 항목의 손잡이가 hTreeWnd 라는 배럴에 보관되여 있는 점에 주의해야 한다. 이 
손잡이들은 나무목록에서 선택된 항목을 식별하는데 사용된다. 

hTreeCurrent 는 현재 선택 되 여 있는 항목을 식별하기 위 한 손잡이 이 다. 이 손잡이 
는 사용자가 차림표를 사용하여 가지를 전개하거나 접는 때 사용된다. 

WindowFunc ( ) 의 내 부 에 서 는 새 로 운 항 목 이 선 택 되 였 을 때 발 송 되 는 
WM_NOTIFY 통보문을 처리하고 있 다. 

itemNew 의 값과 배 렬 hTreeWnd 에 보관된 항목의 손잡이 목록을 비 교하고 있다. 
일치하는 손잡이가 있으면 새롭게 선택된 항목을 창문에 표시한다. 

이 실례프로그람에서는 나무구조보기조종체의 기본적 인 사용방법만을 보여 주며 전 
체 기능의 일부밖에 사용하지 않고 있다. 나무구조보기조종체를 사용하여 한 나무로부터 
다른 나무에 항목을 끌어 다 놓는것같은 고급한 기능은 자체로 알아 보아야 한다. 


|다시 한보 전진| 


나무구조보기조종제의 표식의 편집 (Label editing ) 

나무안에 표시된 표식의 내용을 변경할수 있는 나무구조보기조종체를 작성할 
수도 있다. 그러자면 나무구조보기조종체를 작성할 때의 형식에 
TVS_EDITLABELS 를 포함시 킨다. 

표식의 변경은 TVN_BEGINLABELEDIT 및 TVN_ENDLABELEDIT 라는 
두개의 통지문에 의해서 통지된다. (통지문은 WM_NOTIFY 통보문과 함께 발송된 
다는데 주의해 야 한다. ) 

두 통보문에 있어서 lParam 에는 아래 에 보여 준 NMTVDISPINFO 구조체의 
지시자가 보관되여 있다. 

typedef struct tagNMTVDISPINFO { 

NMHDR hdr ； 

TVITEM item ； 

} NMTVDISPINFO ； 

사용자가 표식의 변경을 시작하면 TVN_BEGINLABELEDIT 통지문이 발송 
된다. 사용자에게 표식의 편집을 허가하려면 프로그람에서 령을 돌려 준다. 편집 
을 금지하려 면 령 아닌 값을 돌려 준다. 

사용자가 편집 을 끝내면 TVN_EDNLABELEDIT 통지문이 발송된다. 사용자 
가 편집을 취소한 경우에는 Item 의 pszText 성원에 NULL 이 보관된다. 그렇지 
않은 경우에는 pszText 성원에 새로운 표식의 지시자가 보관된다. 편집이 취소된 
경 우에 는 프로그람에 서 령 을 돌려 주어 본래 의 표식 으로 복귀할수 있 다. 그렇 지 


434 


교육성 프로그람교육쎈터 





제 12 장. 상태창문, 표쪽조종체 및 나무구조보기조종체 


않은 경우에는 령 아닌 값을 돌려 주며 새로운 표식 이 사용된다. 

실례프로그람을 개조하여 표식을 변경 하는 기능을 시험해 보기 위해 나무구조보 
기조종체를 작성할 때의 형식에 TVS_EDITLABELS 를 추가하고 WindowsFunc ( ) 
의 WM_NOTIFY 의 case 문을 아래의 프로그람코드와 치환해 본다. 

case WM_NOTIFY ： 

nmptr = (LPNMTREEVIEW) IParam ； 
switch (nmptr- 〉 hdr. code) { 
case TVN_BEGINLABELEDIT : 
return 0 ； 

case TVN_ENDLABELEDIT : 
if (((NMTVDISPINFO *) nmptr) - >item. pszText) 
return 1 ； // 표식 이 편집되였다 . 
else 

return 0 ； // 사용자가 취소했다 . 

} 

break ； 

이 러한 변경을 진행하면 나무구조보기조종체의 표식을 변경할수 있게 된다. 
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특성표와 조수 


이 장에서는 Windows 2000 의 가장 흥미 있는 조종체의 하나인 조수 
( Wizard ) 의 작성 방법 에 대 해 설명한다. 조수는 복잡한 사용자입 력 을 인도 
하기 위해 련속적으로 표시되는 대화칸들의 모임이다. 조수를 구성하는 대 
화칸들은 조수에 의해 표시되는 순서로 조작된다. Windows 2000 에서는 
많은 장면들에서 조수가 사용된다. 례를 들어 새로운 인쇄기를 설치할 때 
는 인쇄기추가조수가 사용된다. 

후에 알게 되지만 조수는 특성표 (Property sheet ) 라고 부르는 공통조 
종체를 사용하여 작성된다. 특성표는 어떤 항목의 속성값을 표시하거나 속 
성 값을 설정하는데 사용된다. 앞장에서 설명한 표쪽조종체 와 형 태적 으로 
류사하지만 특성표가 보다 강력한 기능을 가지고 있다. 

특성표가 조수의 기초로 되는것만큼 우선 특성표에 대한 설명으로부터 시 
작해 보자. 
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특성표의 기초 


특성표 (Property sheet ) 는 사용자에게 어떤 항목과 관련된 여 러 가지 속성 들을 표시 
하거나 속성을 설정하도록 하기 위한것이다. 실례로 인쇄기나 모뎀의 설정 등에 특성표 
가 리용되고 있다. 사용자의 시점에서 보면 특성표는 한개이상의 폐지들의 집합체이다. 
매 폐지에는 표쪽이 붙어 있다. 표쪽을 선택하면 그 폐지가 능동상태로 된다. 그림 13-1 
에 특성표의 실례를 보여 주었다. 



3 B 13-1. 특성표의 례 


프로그람작성 자의 시 점 에 서 보면 특성 표는 한개 이 상의 비양식화대화칸의 집 합체 이 다. 
특성표의 매 페지는 대화칸본보기 (Dialog box template ) 에서 정의되고 그의 처리는 대 
화함수에서 진행된다. 매 대화칸본보기는 응용프로그람의 자원 파일에서 정의된다. 

모든 특성표에는 [ OK ] 와 [ Cancel ] 의 두 단추가 있다. [ Apply ] 라는 세번째 단추가 
있는 경우도 종종 있다. 또한 [ Help ] 단추가 있는 경우도 있다. 

매 페지와 관련된 대화함수가 사용자에게 속성을 표시하거나 설정하도록 하는 기능 
을 제공하고 있지만 사용자의 조작을 얻거나 취소하는 기능은 특성표조종체만이 제공한 
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다. 달리 말한다면 매 페지의 대 화함수에는 [ OK ] 나 [ Cancel ] 단추가 들어 있지 않다는 
것 이 다. 이 두 단추는 특성표조종체에 의해 제공된다. 

특성 표를 구성하는 대 화칸은 특성 표조종체 의 한 부분으로 된 다. 특성 표조종체 는 매 
폐지 및 폐지사이의 련관을 관리한다. 매 대화함수는 그 안의 조종체들을 보통 때처럼 
관리한다. 다시말하여 매 폐지의 조종체들은 그 페지의 대화함수에서 표준적인 수법으로 
조작할수 있다. 그러나 매 폐지는 그것이 속해있는 특성표로부터 보내 오는 통보문에도 
응답할 의무가 있다. 특성표가 매 폐지와 통신을 취하는 경우에는 WM_NOTIFY 통보문 
을 전송한다. 특성표의 매 폐지는 이 통보문에 응답하여 야 한다. (자세한 처 리내용에 대 
해서는 뒤 에서 설명한다.) 

특성 표를 작성할 때 지 켜 야 할 중요한 규칙 이 하나 있 다. 그것은 매 페 지 와 련관된 
비양식화대화칸이 자기자체를 닫아서는 안된다는것 이 다. 이것은 DestroyWindow ( )를 
호출해서는 안된다는 의미이다. 그대신 특성표조종체가 대화칸을 닫는 처리를 진행한다. 
만일 한개 폐지의 대화칸을 닫아 버렸다면 그 대화칸만이 비여 있게 되고 만다. 이것은 
Windows 2000의 형식에 위반되는것이다. 

참고 : 특성표는 공통조종체로서 제공되므로 프로그람에 COMMCTRL.H 를 포함시키고 
COMCTL 32. LIB 를 련결 하여 야 한다. 


특성표의 작성 


특성표를 작성하려 면 아래 와 같은 네 가지 단계 가 필요하다. 

• PROPSHEETPAGE 구조체 에 매 폐 지 의 정 보를 설 정 한다. 

• CreatePropertySheetPage ( )를 호출하여 매 페지를 작성한다. 

• PROPSHEETHEADER 구조체 에 특성 표자체 의 정 보를 설 정 한다. 

• PropertySheet ( )를 호출하여 특성 표를 작성 하거나 표시 한다. 

그러면 매 단계를 설명해 보자. 

특성표의 페지정의 

특 성 표 의 매 폐 지 는 PROPSHEETPAGE 구조///에 정 의 하 여 야 한 다 . 
PROPSHEETPAGE 구조체 를 아래 에 보여 주었 다. 
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typedef struct .PROPSHEETPAGE { 

DWORD dwSize ； 

DWORD dwFlags ； 

HINSTANCE hlnstance ； 
union { 

LPCSTR pszTemplate ； 

LPCDLGTEMPLATE pResource ； 

}； 

union { 

HICON hlcon; 

LPCSTR pszlcon ； 

}； 

LPCSTR pszTitle ； 

DLGPROC pfnDlgProc ； 

LPARAM IParam ； 

LPFNPSPCALLBACK pfnCallback ； 

UINT FAR *pcRefParent; 

LPCSTR pszHeaderTitle ； 

LPCSTR pszHeaderSubTitle; 

} PROPSHEETPAGE ； 

dwSize 에 는 PROPSHEETPAGE 구조체 의 크기 를 byte 단위 로 설 정 한다. 
dwFlags 의 값은 유효한 정보가 들어 있는 성원을 가러킨다. 이 값은 표 13-1 에 보 
여 준 한개 이 상의 기 발들의 조합이 여야 한다. 이 기 발들은 OR 연산자를 리용하여 조합 
할수 있다. 


표 13-1. _ PROPSHEETPAGE 의 dwFlags 성 원의 값 


PSP.DEFAULT 

체계설정을 사용한다. + ^ 

PSP—DLGINDIRECT 

pszTemplate 가 아니 라 pResource 를 사용한다. 

PSP HASHELP 

[ Help ] 단추를 표시한다. 

PSP_HIDEHEADER 

조수에 머 리 부를 표시하지 않는다.(조수의 경 우 
에 만) 

PSP.PREMATURE 

특성표조종체 가 작성될 때 폐 지도 작성한다. 보 
통은 패지가 제일 처음 능동으로 될 때까지 작성되 
지 않는다. 
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PSP—RTLREADING 

본문을 오른쪽에서 왼쪽으로 표시한다 

PSP USECALLBACK 

pfnCallback 를 유효로 한다. 

PSP—USEHEADERTITLE 

pszHeaderTitle 을 유효로 한다. (조수의 경우에 
만) 

PSP 一 USEHEADERSUBTIT 

pszHeaderSubTitle 을 유효로 한다. (조수의 경 

LE 

우에만) 

PSP USEHICON 

hlcon 을 유효로 한다. 

PSP—USEICONID 

pszlcon 을 유효로 한다. 

PSP_USEREFPARENT 

참조계수기를 유효로 하는 PSPJJSETITLE 폐지 
의 대화칸본보기에서 정의된 제목이 아니라 
pszTitie 에서 지정된 형식을 사용한다. 


hlnstance 에는 응용프로그람의 실체손잡이를 설정한다. pszTemplate 에는 폐지에 
련관된 대 화칸본보기 의 이 름이 나 ID 를 설정 한다. 그러 나 PSP _ DIjGINI)mECT 기 밭을 
설정 한 경 우에 는 pszTemplate 가 무시 되 고 pResource 에 서 지 정 된 대 화칸이 사용된다. 

폐지의 표쪽에 작은 아이콘을 포함시키려는 경우는 그것을 hlcon 혹은 pszlcon 의 
어느 하나에 설정한다. 이 경우에는 적절한 기발도 설정해야 한다. hlcon 에는 아이콘의 
손잡이를 설정한다. pszlcon 아이콘에는 자원에서 정의된 아이콘의 이름 혹은 ID 를 설정 
한다. 

일반적으로는 폐지에 련관된 대화칸의 제목이 그 폐지의 제목으로 된다.이 제목은 
폐지의 표쪽에 표시된다. 그러나 pszTitle 에 새로운 제목으로 될 문자렬의 지시자를 설 
정 하여 다른 제 목을 표시 할수도 있 다. 이 경 우에 는 PSP_USETITLE 끼 밭쐴: 설 정 하여 야 
한다. 

페 지 에 련관된 비양식 화대 화칸의 대 화함수를 pfnDlgProc 에 설정 한다. 

IParam 에는 응용프로그람 자체의 자료를 설정할수 있다. 

pfnCallback 를 유효로 한 경우에는 폐지가 작성되거나 파괴될 때 호출되는 역호출 
함수를 지정 할수 있다. 이 함수는 이 장의 실례 프로그람에서는 요구되지 않지 만 자체로 
작성 하는 응용프로그람에서 이 함수가 필요한 경우에는 다음과 같은 방법 으로 선언하여 
야 한다. 


UINT CALLBACK PropPageFunc (HWND hwnd , UINT message , 
LPPROPSHEETPAGE IpPropSheet ) : 

이 함 수 가 호 출 될 때 는 hwnd 값 이 NULL 로 된 다 . messge 의 값 은 
PSPCB_ADDREF (폐지가 참조되려고 하고 있다)， PSPCB_CREATE (패지가 작성되려고 
하고 있다) 또는 PSPCD_RELEASE (폐지가 해제되려고 하고 있다)중의 어느 하나로 된 
다. IpPropSheet 는 대상으로 되는 폐지의 PROPSHEETPAGE 구조체의 지시자이다. 
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message 의 값이 PSPCB_CREATE 인 경우는 함수에서 령 아닌 값을 돌려 주어 
작성을 실행하고 령을 돌려 주어 폐지의 작성을 취소할수 있 다. message 의 값이 
PSPCB_ADDREF 혹은 PSPCD_RELEASE 인 경우는 돌림값이 사용되지 않는다. 

pcRefParent 에는 참조계수기로 되는 변수의 주소를 설정한다. 이 성원은 
PSP_USEREFPARENT 가 설정된 경우에만 유효하다. 

pszHeaderTitle 와 pszHeaderSubTitle 은 조수인 경우에만 유효하게 된다. 이 성 
원들에 는 제 목 혹은 부분제 목으로 되 는 문자렬의 지 시 자를 설정한다. 이 문자렬들은 조 
수의 머 리부령 역 에 표시 된 다. dwFlags 의 값에 PSP_USEHEADERTITLE 혹은 
PSP_USEHEADERSUBTITLE 이 포함되여 있지 않는 경우는 이 두개의 성원들이 무 
시된 다. 


이식과 관련한 요점: 이전의 PROPSHEETPAGE 구조체 에 는 pszHeaderTitle , 
pszHeaderSubTitle 및 그것들과 관계되는 기발들이 들어 있지 않다. 

매 패지의 초기화 

PROPSHEETPAGE 구조체 에 필요한 정 보를 설정 하고 나서 Create Property 
SheetPage ( ) 를 호출하여 폐지 를 작성 한다. 선언은 다음과 같다. 


HPROPSHEETPAGE CreatePropertySheetPage ( 

LPCPPROPSHEETPAGE IpPage ) : 


IpPage 에 는 PROPSHEETPAGE 구조체 의 지 시 자를 설정 한다. 이 함수는 새 롭게 
작성된 폐지의 손잡이 를 돌려 준다. 이 손잡이는 후에 특성표를 작성할 때 펼요하므로 
보관해 둔다. 폐지를 작성할수 없는 경우에는 함수의 돌림값이 NULL 로 된다. 

PROPSHEETHEADER 구조체으 I 초기호 F 

매 폐지의 작성이 끝나면 PROPSHEETHEADER 구조체에 특성표의 초기화정보를 
설정한다. PROPSHEETHEADER 구조체의 정의를 아래에 보여 주었다. 


typedef struct .PROPSHEETHEADER { 
DWORD dwSize ； 

DWORD dwFlags ； 

HWND hwndParent ； 

HINSTANCE hlnstance ； 
union { 
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HICON hlcon ； 

LPCSTR pszlcon ； 

}； 

LPCSTR pszCaption ； 

UINT nPages ； 
union { 

UINT nStartPage; 

LPCSTR pStartPage; 

}； 

union { 

LPCPROPSHEETPAGE ppsp ； 
HPROPSHEETPAGE FAR *phpage; 

}； 

PFNPROPSHEETCALLBACK pfnCallback ； 
union { 

HBITMAP hbmWatermark ； 

LPCSTR pszbmWatermark ； 

}； 

HPALETTE hplWatermark ； 
union { 

HBITMAP hbmHeader ； 

LPCSTR pszbmHeader ； 

}； 

} PROPSHEETHE ADER ； 


dwSize 에 는 PROPSHEETHEADER 구조체 의 크기 를 byte 단위 로 설 정한다. 
dwFlags 의 값은 유효한 정보가 보관되여 있는 성원을 가리키는 값이다. 이 값은 
표 13-2 에 보여 준 한개 이 상의 기 발의 조합이 여야 한다. 이 기 발들은 OR 연산자를 사용 
하여 조합할수 있다. 


표 13-2. _ PROPSHEETHEADER 의 dwFlags 성 원의 값 


PSH_DEFAULT 

체계설정을 사용한다. 

PSH HASHELP 

[ Help ] 단추를 유효로 한다. 

PSH—HEADER 

머 리 부에 비 트매 프를 표시 한다. (조수의 경 
우에만) 
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PSH_MODELESS 

비양식 화특성표조종체 를 작성한다. 체 계 설 
정 으로 특성표조종체 는 양식 화로 된 다. 

PSH NOAPPLYNOW 

[ Apply ] 단추를 표시하지 않는다. 

PSH_NOCONTEXTHELP 

상황의존도움말의 ?를 표시하지 않는 
다.(특성표의 경 우에 만) 

PSH—PROPSHEETPAGE 

ppsp 를 유효로 하고 phpage 를 무효로 
한다. 

PSH_PROPTITLE 

pszCaption 에 지정된 제목에 [Property 
of ] 라는 문자렬을 추가한다. 

PSH RTLREANDING 

본문을 오른쪽에서 왼쪽으로 표시 한다. 

PSH USECALLBACK 

pfnCallback 을 유효로 한다. 

PSH_USEHBMHEADER 

hbmHeader 를 유효로 한다. 그렇지 않 
은 경 우는 pszbmHeader 가 사용된다. (조 
수의 경우에만) 

PSH_USEHBMWATERMARK 

hbmWaterMark 를 유효로 한다. 그렇지 
않은 경 우는 pszbmWaterMark 가 사용된 
다.(조수의 경 우에 만) 

PSH USEHICON 

hlcon 을 유효로 한다. 

PSH USEICONID 

pszlcon 을 유효로 한다. 

PSH_USEHPLWATERMARK 

hplWaterMark 를 유효로 한다. (조수의 
경우에만) 

PSH_USEPAGELANG 

사용되는 언어가 선두폐지에 정의된것이라 
는것 을 가리킨다. 

PSH_USEPSTARTPAGE 

pStartPage 를 유효로 하고 nStartPage 
를 무효로 한다. 

PSH WATERMARK 

투명도안을 포함한다. (조수의 경우에 만) 

PSH—WIZARD 

조수를 작성한다. 

PSH _ WIZARD 97 

머리부의 제목과 부문제목，투명도안 및 
비트매프를 포함한 조수를 작성한다. 이것은 
Windows 2000 조수에 서 사용되 는 형 식 이 다. 

PSH_WIZARDHASFINISH 

조수의 모든폐지에 [ Finish ] 단추를 포함한 
다.(조수의 경 우에 만) 

PSH _ WIZARD_LITE 

PSH _ WIZARD 97 에 류사한 간단한 조수 
를 작성한다. 


hwndParent 에는 특성 표의 어 미 창문의 손잡이 를 설정 한다. hlnstance 에 는 응용프 
로그람의 실체손잡이를 설정한다. 
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특성표의 제목띠에 작은 아이콘을 표시하려는 경우에는 그것을 hlcon 혹은 pszlcon 
에 설정한다. 이 경우에는 적절한 기 발설정도 필요하게 된다. hlcon 에는 아이콘의 손잡 
이를 설정한다. pszlcon 에는 자원파일에 정의되여 있는 아이콘의 이름 혹은 ID 를 설정 
한다. 

특성 표조종체 의 창문제 목을 pszCap 吐 on 에 설정 한다. 특성 표의 폐 지 수를 nPages 에 
설정 한다. 

특성표가 능동상태로 되였을 때 제일 먼저 표시되는 폐지의 색인을 nStartPage 혹 
은 pStartPage 의 어 느 하나에 설정한다. 체 계설정 으로는 nStartPage 가 사용된 다. 
nStartPage 에 는 첫 패지의 색 인을 설정한다. 폐지의 색 인값은 령 으로부터 시 작한다. 
PSHJJSEPSTARTPAGE 기발을 설정한 경우는 pStartPage 에 폐지의 이름 혹은 ID 를 
설정하여야 한다. 

phpage 에는 특성표의 매 페지의 손잡이를 보관한 배럴의 지시자를 보관한다. 이 
손잡이 들은 앞에 서 설명 한 CreatePropertySheetPage ( )를 사용하여 작성 된 다. 그러 나 
PSH_PROPSHEETPAGE 기 발 을 설 정 한 경 우 에 는 이 방 법 이 아 니 라 ppsp 에 
PROPSHEETPAGE 구조체 배 럴의 주소를 설정하여 야 한다. 이 경 우에 는 손잡이 가 자동 
적 으로 작성 되 므로 CreatePropertySheetPage ( )를 호출할 펄 요가 없 다. 다만 다른 처 리 
에서도 폐지의 손잡이를 사용하는 경우가 있으므로 손잡이를 명시적 으로 작성하는 방법 
을 사용하는편이 유익하다. 

pftiCallback 가 유효한 경우에는 거기에 특성표가 작성되였을 때 호출되는 역호출함 
수를 설정한다. 이 장의 실례프로그람에서는 사용되지 않지만 이러한 역호출함수가 필요 
하게 되는 경우도 있다. 이 역호출함수는 다음과 같이 선언하여야 한다. 


int CALLBACK PropSheetFunc (HWND hdwnd , UINT message , 

LPARAM IParam ) : 

이 함수가 호출되였을 때 hdwnd 에는 특성표조종체의 손잡이가 보관된다. message 
의 값은 PSCB .INITIALIZED ( 특성 표가 초기화되려고 하고 있 다.) 또는 
PSCB_PRECREATE (특성 표가 작성 되려고 하고 있 다.) 의 어느 한 값으로 된 다. 
PSCBJNITIALIZED 의 경 우에 는 IParam 에 령 이 보관된 다. PSCB_PRECREATE 의 경 
우에 는 IParam 에 대 화칸본보기 의 지 시 자가 보관되 고 hdwnd 에 NULL 이 보관된다. 어 
느 경우에도 함수의 돌림값으로서 령을 돌려 주어야 한다. 

조수에 서 는 투명도안과 머리부비 m 매프를 설정할수 있 다. 투명 도안 ( Watermark ) 은 
폐지의 왼쪽에 표시되는 비트매프이다. 머리부비트매프 (Header bitmap ) 는 조수의 머리 
부의 오른쪽에 표시 된 다. 이 비 트매 프들을 표시하려 면 PSH _ WIZARD 97 을 포함하여 적 
절한 기 발을 설정 하여 야 한다. PSH _ WIZARD 97 은 Windows 2000 에서 주장되 고 있는 
형식이므로 Windows 2000의 모든 조수들은 이리한 비트매프들을 사용해야 한다. 

hbmWatermark 에 투명도안으로 사용되는 비트매프의 손잡이를 설정한다. 
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pszbmWatermark 를 사용하여 비트매프의 이름을 설정 할수도 있다. 일반적으로는 체계 
설정의 조색판을 사용하여 투명도안이 그려 지지만 hprWatermark 에 조색판의 손잡이를 
설정할수도 있다.어느 경우에나 적절한 기발을 설정하여야 한다. 

머 리부비트매 프의 손잡이를 hbmHeader 에 설정 한다. pszbmHeader 에는 머 리부의 
자원이름을 설정할수도 있다. 이 경우도 적절한 기발을 설정해야 한다. 

이식과 관련한 요점 : 이전의 PROPSHEETHEADER 에는 hbmWatermark, 
pszbmWatermark, hplWatermark, hbmHeader 및 pszbmHeader 가 없다. 이 성원들을 
유효하게 하는 기발도 정의되여 있지 않다. 

특성표조종체의 작성 

폐지의 정의와 PROPSHEETHEADER 구조제와 정의가 끝나면 특성표조종제를 작성 
할수 있 다. 그러 자면 PropertySheet( ) 함年를 사용한다. 아래 에 선언을 보여 주었 다. 


int PropertySheet(LPCPPROPSHEETHEADER lpHeader ) ； 

lpHeader 에 는 PROPSHEETHEADER 구조체 의 지 시 자를 설정 한다. 호출이 성 공하 
면 정 의 값이 돌려 지 고 실패하면 부의 값 (-1) 이 돌려 진다. 비양식 화특성 표조종체 를 작성 
할 때 는 ( PSH_MODELESS 기 발을 설정한 경 우) 특성 표의 손잡이 가 돌려 진다. 


특성표■보문의 처리 


이 미 설명한바와 같이 특성표조종체 는 WM_NOTIFY 통보문을 사용하여 매 폐지의 
대화함수에 통지문을 보낸다. 대부분의 통지문에서 IParam 에는 아래 에 보여 주는 
P 5 H / V 幻 77 Fr 구조체의 지시자가 보관된다. 


typedef struct _PSHNOTIFY { 

NMHDR hdr ； 

LPARAM IParam ； 

} PSHNOTIFY ； 

첫 성원인 NMHDR 구조제는 통지문의 내용을 가리킨다. NMHDR 구조체의 정의는 
다음과 갈다. 


typedef struct tagNMHDR 
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{ 

HWND hwndFrom; 
UINT idFrom ； 
UINT code ； 

} NMHDR ； 


특성 표의 WM_NOTIFY 통보문의 경 우에 는 hwndFrom 에 특성 표조종체 의 손잡이 가 
보관된 다. code 의 값은 조작내 용을 알려 주는 통지 문으로 된다. PSHNOTIFY 구조체 의 
lParam 은 모든 통보문에서 사용되는것은 아니 다. 그것 이 사용되는 경우에만 그 속에 통 
보문의 보충정보가 보관된다. 이 장의 실례프로그람에서 lParam 의 값은 사용되지 않는 
다. hdr 의 정보만이 필요로 된다. 

특성 표조종체 는 매 대 화칸에 서 발생 한 여 러 가지 사건을 알려 주기 위하여 통지 문을 
사용한다. 례하면 폐지가 선택된 때, 특성표의 단추가 눌러워 진 때, 또는 폐지가 변경 
된 때 등에서 통지문이 발송된다. 

통지 문은 아래 조건을 정 확히 알려 주는것 이 다. 주요한 통지 문을 표 13-3 에 주었 다. 


표 13-3. 특성표의 주요통지문 


PSN_APPLY 

사용자가 [ Apply ] 또는 
[ Ok ] 단추를 눌렀 다. 

변경을 허가하는 경우는 
PSNRET — NOERROR , 변 경 
을 허가하지 않는 경우는 
PSNRET _ INVALID_NOCH 

ANGEPAGE 

PSN_HELP 

사용자가 [ Help ] 단추를 
눌렀다. 

없음 

PSN_KILLACTIVE 

폐지가 초점을 잃었거나 
[ OK ] 단추를 눌렀 다. 

비능동으로 하는것 을 허 가 
하는 경우 령，허가하지 않 
는 경우 령 아닌 값 

PSN_QUERYCANCEL 

사용자가 [ Cancel ] 단추 
를 눌렀다. 

Cancel 을 허가하는 경우는 
령，허 가하지 않는 경우는 
령 아닌 값 

PSN_RESET 

사용자가 [ Cancel ] 단추 
를 눌렀다. 

없음 

PSN—SETACTIVE 

폐지가 초점을 가졌 
다. (능동으로 되 였 다. ) 

능동으로 한다는것을 허가 
하는 경우 령, 그렇지 않은 
경우는 능동으로 하는 폐지 
의 ID 
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PSN_WIZBACK 

사용자가 [ Back ] 단추를 
눌렀 다.(조수의 경 우에 
만) 

앞폐지를 능동으로 하는 
경우는 령, 그렇지 않는 경 
우는 -1 또는 능동으로 하는 
폐지의 ID 

PSN_WIZFINISH 

사용자가 [ Finish ] 단추 
를 눌렀다.(조수의 경우 
에 만) 

조수를 완료하는 경우 령, 
그렇지 않는 경우는 령 아닌 
값 

PSN_WIZNEXT 

사용자가 [ Next ] 단추를 
눌렀다. 

다음 폐지를 능동으로 하 
는 경우에는 령，그렇지 않 
은 경우는 -1 또는 능동으로 
하는 폐지의 ID 


일부 상황에서는 대화함수가 특성표조종체에 값을 돌려 주어 통지문에 응답한다. 그 
렇게 하려면 SeOF / ncbwLoiTg •시함수를 사용한다. 이 함수는 창문과 관련된 여 러가지 속 
성들을 설정한다. SetWindowLong ( ) 함수의 선언을 아래에 보여 주었다. 

LONG SetWindowLong (HANDLE hwnd , int index , 

LONG value ) : 

hwnd 에는 대화칸의 손잡이를 설정한다. index 에는 설정할 속성의 종류를 설정한 
다. 특성표에 값을 돌려 주는 경우에는 index 에 DWL _ MSGRESULT 를 설정한다. 실제 
로 돌려 주는 값은 value 에 설정한다. 대화함수에서 통보문을 처리한 때는 TRUE , 처 
리하지 못한 때 는 FALSE 를 돌려 준다. 

SetWindowLong ( ) 함수를 사용하여 돌림값을 돌려 주는 수법은 WM_NOTIFY 통 
보문의 경우에만 사용된다. 


특성표에 통보문들 보내기 


통보문을 받을뿐만아니 라 응용프로그람이 특성표조종체 에 통보문을 보낼수도 있 다. 
이를 위 하여 통보문을 받는 측으로 특성 표조종체의 손잡이를 지정 하여 SendMessage ( ) 
를 사용한다. 특성표에 보내는 모든 통보문은 PSM _ 이 라는 앞붙이로 시 작한다. 주요한 
통보문들을 표 13-4 에 주었 다. 
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표 13-4. 특성 표의 주요통보문 




PSM_APPLY 

PSN_APPLY 통 보 문 을 보 낸 다 . IParam 과 
wParam 에 령 을 설 정한다. 호출이 성 공하면 령 
아닌 값이 돌려 지고 실패하면 령이 돌려 진다. 

PSM_CHANGED 

[ Apply ] 단추를 유효로 한다. IParam 에 령 을 설 
정한다. wParam 에는 페지의 대화칸의 손잡이를 
설정한다. 돌림값은 돌려 지지 않는다. 

PSM—SETCURSEL 

폐지를 변경한다. 새 로운 폐지의 손잡이를 설정 
한다. wParam 에는 새로운 패지의 색인을 설정한 
다. 호출이 성공하면 령 아닌 값이 돌려 지고 실 
패하면 령이 돌려 진다. 

PSM-SETWIZBUTTONS 

조수의 단추를 유효로 한다.(조수의 경우에만) 
IParam 에는 PSWWIZ _ BACK , PSWWIZ _ NEXT , 
PSWWIZ_FINISH 및 PSWWIZ_DISABLEFINISH 
의 어느 한 기 발을 설정한다. wParam 에는 령을 
설정한다. 돌림값은 돌려 지지 않는다. 

PSM_UNCHANGED 

[ Apply ] 단추를 무효로 한다. IParam 에는 령을 
설정 한다. wParam 에는 페지의 대화칸의 손잡이를 
설정한다. 돌림값은 돌려 지지 않는다. 



Windows 2000 은 특성 표에 통보문을 보내는 조작을 간단히 실현할수 있는 마크로들 
을 제 공하고 있 다. 표 13-4 에 대 응되 는 마크로들을 아래 에 주었 다. 

BOOL PropSheet_Apply ( hPropSheet ) ； 

BOOL PropSheet _ Changed ( hPropSheet , hPageDialog ); 

BOOL PropSheet _ SetCurSel ( hPropSheet , hPage , index ); 

BOOL PropSheet _ SetWizButtons ( hPropSheet , Flags ); 

BOOL PropSheet _ Unchanged ( hPropSheet , hPageDialog ) : 


hPropSheet 에는 통보문을 보내는 특성표조종체의 손잡이를 설정한다. 
hPageDialog 에 통보문을 보내는 폐지의 대화함수손잡이를 설정한다. Index 에 다음에 
선택될 폐지의 색인을 설정한다. hPage 에 폐지의 손잡이를 설정한다. Flags 에 유효로 
할 조수의 단추를 설정한다. PropSheet _ SetWizButtons ( M 크로는 조수의 경우에 만 사용 
된 다. 상세한 내 용은 이 장의 뒤 부분에 서 설 명 한다. 

PSM—CHANGED 통豆_문은 [ Apply ] 단추를 유효로 하는것으로서 특히 중요한 통보문 


448 


교육성 프로그람교육쎈터 












제 13 장. 특성표와 조수 


이 다. 사용자가 조작판에 어 떤 변경 을 진행한 경 우에 는 응용프로그람에 서 특성 표조종체 
에 반드시 이 통보문을 보내 야 한다. 

특성표대화칸의 크기 

특성표의 토대로 되는 대화칸은 임의의 크기로 할수 있다. 그러나 특성표의 크기는 
일 반적 인 관례 를 지 켜 표준적 인 크기 로 설 정하는것 이 좋다. 표준적 인 크기 에 는 다음과 
갈은것들이 있다. 





소형 

PROP _ SM_CXDLG 

PROP _ SM_CYDLG 

중형 

PROP MED CXDLG 

PROP . MED—CYDLG 

대형 

PROP _ LG_CXDLG 

PROP . LG.CYDLG 


이 마크로들은 COMMCTRL.H 에 정의되여 있다. 크기는 대화단위로 정의되여 있 
으며 응용프로그람의 자원파일의 DIALOG 명 령 부분에 서 사용된다. 

특성표의 실례프로그람 


실례 13-1 에 보여 준 프로그람은 세개의 폐지를 가진 특성표를 표시하는 실례이다. 
이 특성표에서는 실제로 어떠 한 속성도 설정하지 않지만 특성표를 작성하거 나 표시 하기 
위해 필요한 절차들을 파악할수 있을것 이 다. 

실 례 13-1. Prop 프로그람 


// 특성표의 실례프로그람 


ttinclude 〈 windows. h> 
ttinclude <cstdio> 

^include <commctrl. h> 
ttinclude "prop.h" 

Mefine NUMSTRINGS 5 
ttdefine NUMPAGES 3 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM); 
BOOL CALLBACK DialogFuncl(HWND, UINT, WPARAM, LPARAM) ； 
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BOOL CALLBACK DialogFunc2 (HWND, UINT, WPARAM, LPARAM); 
BOOL CALLBACK DialogFnnc3 (HWND, UINT, WPARAM, LPARAM) ； 

char szWinName[] = ” My Win”; // 창문들라스의 이름 


HINSTANCE hlnst ； 


HWND hDlg ； // 대화칸의 손잡이 
HPROPSHEETPAGE hPs [NUMPAGES]; 
HWND hPropSheet ； 

HWND hPage [NUMPAGES] ,* 

char list [] [40] = { 

"Windows 2000", 

"Windows NT 4”, 

，’ Windows 98”, 

"Windows 95 M , 

"Windows 3.1” 

}; 


int cbl=0, cb2=0, cb3=0； 
int rbl=l, rb2=0, rb3=0； 
int lblsel=0； 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl; 

HACCEL hAccel ； 

INITCOMMONCONTROLSEX cc ； 

// 창문믈라스률 정의 한다. 
wcl.cbSize = sizeof (WNDCLASSEX) ； 


wcl.hlnstance = hThisInst； // 실체의 손잡이 
wcl. IpszClassName = szWinName； // 창문믈라스의 이름 
교육성 프로그람교육쎈터 


450 



제 13 장. 특성표와 조수 


wcl. lpfnWndProc = WindowFunc ； II 창문함수 
wcl.style = 0; // 체계 설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ; // 큰 아이론 
wcl. hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl. IpszMenuName = "PropSheetMenu" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 


// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


A 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow( 
szWinName, // 창문믈라스의 이름 
"Demonstrate a Property Sheet", // 제목 
WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJUSEDEFAULT, // X 자리 표는 Windows 가 결 정 하게 한다 . 
CWJJSEDEFAULT, // Y 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너비는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림 표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메터는 없 다 . 

)； 


hlnst = hThisInst ； // 현재의 실체손잡이를 보관한다 . 

// 건반가속기를 적재한다 . 

hAccel = LoadAccelerators (hThisInst, "PropSheetMenu") : 
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// 공통조종체를 초기화한다 . 

cc.dwSize = sizeof (INITCOMMONCONTROLSEX) ； 
cc.dwICC = ICC_TAB_CLASSES; 
InitCommonControlsEx (&cc) ； 


// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) ； 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

if (! Translate Accelerator (hwnd, h Accel, &msg)) { 
TranslateMessage(&msg) ； // 건반통보를 변환한다 . 
DispatchMessage(&msg) ； // Windows 2000 에 조종을 넘 긴다 . 

} 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

int response; 

PROPSHEETPAGE PropSheet [NUMPAGES] ； 
PROPSHEETHEADER PropHdr ； 


switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 


case IDM_DIALOG: 

PropSheet [Ol.dwSize = sizeof (PROPSHEETPAGE) ； 
PropSheet [0]. dwFlags = PSP.DEFAULT ； 


452 


교육성 프로그람교육쎈터 



제 13 장. 특성표와 조수 


PropSheet [0]. hlnstance = hlnst; 

PropSheet [0]. pszTemplate = "PropSheetDBl" ； 
PropSheet [0]. pszlcon = NULL ； 

PropSheet [0]. pfnDlgProc = (DLGPROC) DialogFuncl ； 
PropSheet [0]. pszTitle = ” 

PropSheet [0]. IParam = 0 ； 

PropSheet [0]. pfnCallback = NULL ； 


PropSheet [ll.dwSize = sizeof (PROPSHEETPAGE); 
PropSheet [1]. dwFlags = PSP.DEFAULT ； 

PropSheet [1]. hlnstance = hlnst ； 

PropSheet [1]. pszTemplate = ”PropSheetDB2”; 
PropSheet [1]. pszlcon = NULL ； 

PropSheet [1]. pfnDlgProc = (DLGPROC) DialogFunc2 ； 
PropSheet [1]. pszTitle = ””; 

PropSheet [1]. IParam = 0 ； 

PropSheet [1]. pfnCallback = NULL ； 

PropSheet [2]. dwSize = sizeof (PROPSHEETPAGE) ； 
PropSheet [2]. dwFlags = PSP.DEFAULT ； 

PropSheet [2]. hlnstance = hlnst ； 

PropSheet [2]. pszTemplate = ”PropSheetDB3”; 
PropSheet [2]. pszlcon = NULL ； 

PropSheet [2]. pfnDlgProc = (DLGPROC) DialogFunc3 ； 
PropSheet [2]. pszTitle = ”"； 

PropSheet [2]. IParam = 0 ； 

PropSheet [2]. pfnCallback = NULL ； 


hPs [0] = CreatePropertySheetPage (&PropSheet [0]) ； 
hPs [1] = CreatePropertySheetPage (&PropSheet [1]); 
hPs[2] = CreatePropertySheetPage ( 技 PropSheet [2]); 


PropHdr. dwSize = sizeof (PROPSHEETHEADER) ； 
PropHdr. dwFlags = PSH.DEFAULT ； 

PropHdr. hwndParent = hwnd ； 

PropHdr. hlnstance = hlnst ； 

PropHdr. pszlcon = NULL ； 

PropHdr. pszCaption = "Sample Property Sheet" ； 
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PropHdr. nPages = NUMPAGES ； 
PropHdr. nStartPage = 0; 
PropHdr. phpage = hPs; 
PropHdr. pfnCallback = NULL ； 


PropertySheet (&PropHdr); 
break ； 

case IDM_EXIT ： 

response = MessageBox(hwnd, ” Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O) ； 
break ； 

case IDM_HELP ： 

MessageBox(hwnd, "Try the Property Sheet", "Help”, MB_OK) ； 
break ； 

} 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam); 


return 0 ； 

} 

// 첫번째 대화함수 

BOOL CALLBACK DialogFuncl (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

static long index; 
int i; 

char str [80] ； 
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case WM.NOTIFY ： 

switch (((NMHDR *) lParam)->code) { 
case PSN.SETACTIVE ： // 페지 가 입 력초점을 엄었다 . 
hPropSheet = ((NMHDR *) IParam)->hwndFrom : 
SetWindowLong (hdwnd, DWL.MSGRESULT, 0 )； 
index = lblsel ； 
return 1 ； 

case PSN.KILLACTIVE ： // 폐지가 입력초점을 잃었다 . 
lblsel = index ； 

SetWindowLong (hdwnd, DWL.MSGRESULT, 0 )； 
return 1 ； 

} 

break ； 

case WM_COMMAND: 
switch (LOWORD (wParam)) { 
case IDD.OPTIONS ： 

PropSheet_SetCurSel (hPropSheet, hPs [1], 1); 
return 1; 

case IDD.OPTIMIZE: 

PropSheet_SetCurSel (hPropSheet, hPs [2], 2); 
return 1; 

case IDD.LBl ： // 목록칸의 LBN_DBLCLK 률 처 리 한다 . 
PropSheet_Changed(hPropSheet, hdwnd) ； 

// 사용자가 선택을 진행하였는가를 검사한다 . 
if (HIWORD (wParam) ==LBN_DBLCLK) { 
index = SendDlgltemMessage (hdwnd, IDD 一 LB1, 

LB.GETCURSEL, 0, 0); // 색 인을 얻는다 . 
sprintf (str, ’’%s ’’, list [index]) ； 

MessageBox(hdwnd, str, "Selection Made”, MB_OK) ； 

} 

return 1 ； 

} 

break ； 

case WM.INITDIALOG ： // 목록칸을 초기화한다 . 
for(i=0 ； KNUMSTRINGS ； i++) 

SendDlgltemMessage (hdwnd, IDD 一 LB1, 

LB.ADDSTRING, 0, (LPARAM) list [i]) ； 
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// 첫 항목을 선택한다. 

SendDlgltemMessage (hdwnd, IDD_LB1, LB_SETCURSEL, lblsel, 0) ； 


return 1 ； 


return 0 ； 

} 

// 두번째 대화함수 

BOOL CALLBACK DialogFunc2 (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

switch (message) { 
case WM.NOTIFY ： 

switch (((NMHDR *) IParam)->code) { 
case PSN.SETACTIVE : // 폐지가 입력 초점을 엄었다 . 
hPropSheet = ((NMHDR *) IParam)->hwndFrom : 
SetWindowLong (hdwnd, DWL.MSGRESULT, 0); 
return 1 ； 

case PSN.KILLACTIVE : // 페 지 가 입 력 초점을 잃었 다 . 
cbl = SendDlgltemMessage (hdwnd, IDD_CB1, 
BM_GETCHECK, 0, 0); 
cb2 = SendDlgltemMessage (hdwnd, IDD_CB2, 
BM.GETCHECK, 0, 0); 
cb3 = SendDlgltemMessage(hdwnd, IDD_CB3, 
BM.GETCHECK, 0, 0 )； 

SetWindowLong (hdwnd, DWL.MSGRESULT, 0); 
return 1 ； 

} 

break ； 

case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDD_CB1 : 
case IDD_CB2 ： 
case IDD_CB3 ： 

PropSheet_Changed(hPropSheet, hdwnd) ； 
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return 1 ； 
case IDD_ALL ： 

PropSheet_Changed (hPropSheet, hdwnd); 
SendDlgltemMessage (hdwnd, IDD_CB1, BM.SETCHECK, 
BST.CHECKED, 0); 

SendDlgltemMessage (hdwnd, IDD_CB2, BM.SETCHECK, 
BST.CHECKED, 0); 

SendDlgltemMessage (hdwnd, IDD_CB3, BM_SETCHECK, 
BST_CHECKED, 0); 

return 1 ； 

} 

break ； 

case WMJNITDIALOG ： // 검 사칸을 초기 화한다 . 

SendDlgltemMessage (hdwnd, IDD_CB1, BM_SETCHECK, cbl, 0); 
SendDlgltemMessage (hdwnd, IDD_CB2, BM_SETCHECK, cb2, 0) ； 
SendDlgltemMessage (hdwnd, IDD_CB3, BM_SETCHECK, cb3, 0); 
return 1 ； 


return 0 ； 

} 

// 세번째 대화함수 

BOOL CALLBACK DialogFunc3 (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

switch (message) { 
case WM.NOTIFY ： 

switch (((NMHDR *) IParam)->code) { 
case PSN.SETACTIVE ： // 페지 가 입 력초점을 엄었다 . 
hPropSheet = ((NMHDR *) IParam)->hwndFrom : 
SetWindowLong (hdwnd, DWL.MSGRESULT, 0); 
return 1 ； 

case PSN.KILLACTIVE : // 페 지 가 입 력 초점을 잃었 다 . 
rbl = SendDlgltemMessage (hdwnd, IDD_RB1, 
BM_GETCHECK, 0, 0); 
rb2 = SendDlgltemMessage (hdwnd, IDD_RB2, 
BM.GETCHECK, 0, 0); 


교육성 프로그람교육쎈터 


457 



Windows 2000 프로그람작성법 


rb3 = SendDlgltemMessage(hdwnd, IDD_RB3, 

BM_GETCHECK, 0, 0); 

SetWindowLong (hdwnd, DWL.MSGRESULT, 0 )； 
return 1; 

} 

break ； 

case WM_COMMAND: 
switch (LOWORD (wParam)) { 
case IDD_RB1 : 
case IDD—RB2: 
case IDD_RB3 ： 

PropSheet_Changed (hPropSheet, hdwnd) ； 
return 1 ； 

case IDD—FASTEST: 

PropSheet_Changed(hPropSheet, hdwnd) ； 

SendDlgltemMessage (hdwnd, IDD_RB2, BM_SETCHECK, 0, 0) 
SendDlgltemMessage (hdwnd, IDD_RB3, BM_SETCHECK, 0, 0) 
SendDlgltemMessage (hdwnd, IDD_RB1, BM_SETCHECK, 1, 0) 
return 1 ； 


case IDD—SMALLEST: 

PropSheet_Changed(hPropSheet, hdwnd) ； 

SendDlgltemMessage (hdwnd, IDD_RB1, BM_SETCHECK, 0, 0) 
SendDlgltemMessage (hdwnd, IDD—RB2, BM_SETCHECK, 0, 0) 
SendDlgltemMessage (hdwnd, IDD_RB3, BM_SETCHECK, 1, 0) 
return 1 ； 


} 

break ； 


case WMJNITDIALOG ： // 단일선택단추률 
SendDlgltemMessage (hdwnd, IDD_RB1, 
SendDlgltemMessage (hdwnd, IDD_RB2, 
SendDlgltemMessage (hdwnd, IDD_RB3, 


초기화한다. 
BM.SETCHECK, 
BM.SETCHECK, 
BM.SETCHECK, 


rbl, 0) 
rb2, 0) 
rb3, 0) 


return 1 ； 


458 


} 


교육성 프로그람교육쎈터 






제 13 장. 특성표와 조수 


return 0 ； 

} 

이 프로그람은 아래의 자원파일을 필요로 한다. 

// 특성표의 대화칸 
ttinclude < windows. h> 
ttinclude <commctrl.h> 
ttinclude ” prop, h” 


PropSheetMenu MENU 

{ 

POPUP Property Sheet ，， 

{ 

MENUITEM ” &Activate\tF2，，, IDM_DIALOG 
MENUITEM ” E&xit\tCtrl+X", IDM—EXIT 

} 

MENUITEM ”&Help”, IDM_HELP 

} 


PropSheetMenu ACCELERATORS 

{ 

VK_F2, IDM_DIALOG, VIRTKEY 
VK_F1, IDM_HELP, VIRTKEY 
IDM—EXIT 

} 

PropSheetDBl DIALOGEX 0, 0, PROP_SM_CXDLG, PROP_SM_CYDLG 
CAPTION "Pick Target” 

{ 

PUSHBUTTON "Options", IDD.OPTIONS, 11, 24, 34, 14 
PUSHBUTTON "Optimize", IDD.OPTIMIZE, 11, 48, 34, 14 
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CTEXT "Target OS", 1, 66, 14, 60, 14 
LISTBOX IDD.LBl, 66, 30, 60, 44, LBS.NOTIFY | 

WS_BORDER | WS.VSCROLL | WS_TABSTOP 

} 


PropSheetDB2 DIALOGEX 0, 0, PROP_SM_CXDLG, PROP_SM_CYDLG 
CAPTION ” Choose Options" 

{ 

DEFPUSHBUTTON ” All”, IDD.ALL, 11, 10, 34, 14 
AUTOCHECKBOX "Check for stack overflows. M , IDD_CB1, 

56, 10, 110, 10 

AUTOCHECKBOX "Check array boundaries. M , IDD.CB2, 

56, 30, 110, 10 

AUTOCHECKBOX "Prevent assignment to null.，’, IDD.CB3, 

56, 50, 110, 10 

} 


PropSheetDB3 DIALOGEX 0, 0, PROP_SM_CXDLG, PROP_SM_CYDLG 
CAPTION ” Choose Optimization" 

{ 

DEFPUSHBUTTON "Fastest，，, IDD.FASTEST, 11, 10, 34, 14 
PUSHBUTTON ” Smallest”, IDD_SMALLEST, 11, 34, 34, 14 
AUTORADIOBUTTON "Optimize for speed.”, IDD.RB1, 

56, 10, 100, 10 

AUTORADIOBUTTON "Balance speed and size.’，, IDD_RB2, 


56, 30, 100, 10 


AUTORADIOBUTTON "Optimize for size.' 
56, 50, 100, 10 


머리부파일 PROP . H 의 내용을 아래에 주었다. 


ttdefine IDM.DIALOG 100 
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#define IDM.EXIT 101 

Mefine IDM.HELP 102 

Mefine IDD.OPTIONS 201 

ttdefine IDD_OPTIMIZE 202 

#define IDD_FASTEST 204 

Mefine IDD_SMALLEST 205 

ttdefine IDD_ALL 207 

Mefine IDD_LB1 301 

ttdefine IDD.EB1 401 

Mefine IDD_CB1 501 

#define IDD_CB2 502 

Mefine IDD_CB3 503 

Mefine IDD_RB1 601 

Mefine IDD_RB2 602 

ttdefine IDD_RB3 603 

#define IDD_STEXT1 700 


프로그람의 실행결과를 그림 13-2 에 주었다. 

모든 패지의 대화함수들에서 주의를 돌려야 할 점은 사용자가 설정을 변경하였다면 
반드시 PSM.CHANGED 통보문을 보낸다는것 이 다. 례 하면 [Choose Options ] 대화칸에 
서 검사칸의 상태를 변경 하면 PropSheet _ Changed(M 호출된다. PSM — CHANGED 통1 
문을 보내 면 [ Apply ] 단추의 상태 가 무효로부터 유효로 바권다. 일 반적 으로 속성 설정 이 
변경되면 그것을 특성표에 통지해야 한다. 특성표의 첫 페지의 [ Options ] 단추와 
[ Optimize ] 단추를 처리 하는 부분에서 프로그람코드를 사용하여 폐지선택을 조종하는 방 
법을 보여 주고 있다. [ Options ] 단추를 누르면 두번째 페지가 선택되며 [ Optimize ] 단추 
를 누르면 세번째 폐지가 선택된다. 이 실례프로그람은 조작상 이 단추를 필요로 하지 않 
지만(폐지의 표쪽을 누르면 그 폐지를 선택할수 있기때문에 ) PSM __ SETCURSELll ^\ 
사용법을 보여 주기 위하여 단추를 사용하고 있다. 

이 실례프로그람의 대화칸은 그 어떤 실제적인 기능도 수행하지 않는 허위적인것으로 
서 특성 표의 사용법 을 보여 줄뿐이 다. 례 하면 사용자가 [ OK ] 단추를 누르든가 다른 패지 
로 이동하면 PSN.KIILLACTIVE 통보문이 발송되여 사용자가 진행한 변경 이 보관되지만 
사용자가 [ Cancel ] 단추를 누른 경우에는 현재패지 에서 진행된 모든 변경 이 무시된다. 
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[ Cancel ] 단추를 눌러서 다른 폐지의 변경내용을 되살릴수는 없다. 이 기능은 자체로 추가 
해 볼수 있다. PSN_APPLY 통보문을 처 리하는 기능도 추가해 보는것 이 유익하다. 




|다시 한보 전진| 


PSN _ H 타 _ PS 보문에 대한 응답 

특성표폐지를 작성할 때 PSP_HASHELP 기발을 포함시키면 그 폐지가 능동 
으로 되 였을 때 특성표에 [ Help ] 단추가 표시된다. 이 단추를 누르면 PSN_HELP 
라는 통지문이 발송된다. 

Windows 의 도움말체계를 사용하는 대부분의 응용프로그람들에서는 (도움말 
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에 대해서는 제 16 장에서 설명한다.) 특성표조종체와 관련된 도움말체계도 제공하 
고 있다. 그러나 Windows 의 도움말체계는 그것 이 세 련된것과 마찬가지로 복잡 
한것 이기도 하다. 그러 나 특성표에 한정시키면 PSN_HELP 통보문에 대 한 응답으 
로서 간단히 통보칸을 표시하도록 할수 있 다. 

[ Help ] 단추의 기능을 시험해 보기 위해 특성표실례프로그람을 개조해 보자. 
우선 아래에 보여 준것 처럼 PropHdr 구조체의 성원에 PSH _ HASHELP 기발을 추 
가한다. 

PropHdr. dwFlags = PSH_DEFAULT | PSH_HASHELP ； 

다음 특성표의 매 폐지 에 PSP_HASHELP 기 발을 추가한다. 실례 로서 첫 페 
지의 경우를 보여 주었다. 

PropSheet [0]. dwFlags = PSP ᅳ DEFAULT | PSP—HASHELP; 

마지 막으로 특성표의 매 폐지의 대화함수에서 WM_NOTIFY 통보문을 처 리 하 
는 부분에 통지문 PSN_HELP 의 처리를 추가한다.실례로 첫 폐지의 대화함수의 
경우를 아래에 보여 주었다. 

case PSN_HELP: 

MessageBox (hdwnd, 

“Pick Target allows you to choose \n” 

"the target operating system.”, 

“Target”, MB_OK); 

return 1 ； 

[ Help ] 단추를 추가한 [Pick Target ] 페지를 아래 에 보여 주었다. 
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조수의 작성 


프로그람작성자의 시점에서 보면 조수는 련속적으로 표시되는 특성표이다. 조수는 
이 미 설 명 한 PROPSHEETPAGE 구조제와 PROPSHEETHEADER 구조제我 서 정 의 되 고 
CreatePropertySheetPage( ) 항수와 PropertySheet () 함수아 의 해서 작성된다. 조수를 
작성하려면 PROPSHEETHEADER 구조체의 dwFlags 성원에 아래 에 보여 주는 기 발들 
가운데서 하나를 설정해 야 한다. 


PSH _ WIZARD 97 

새로운 형식의 조수를 작성한다. 

PSH WIZARD 

낡은 형식의 조수를 작성한다. 

PSH _ WIZARD_LITE 

간소한 형식의 조수를 작성한다. 


이 기발들중하나를 포함시키면 매 대화칸이 자동적으로 처음부터 마지막까지 순번대 
로 표시되게 조수를 작성 할수 있다. Windows 2000 에서 사용되는 조수의 형식은 
Microsoft 의 Wizard 97 규칙 에 준한것 이며 형식 에 PSH—WIZARD97 을 포함시킨다. 이 
장에서는 이 형식의 조수에 대해서만 설명한다. 


Wizard97 규직 

몇년전에 처음으로 조수가 등장한 때는 조수의 모양이나 조작성을 명백히 정의하는 
규칙이 없었다. 이것을 제정하기 위하여 Microsoft 는 的 fea / Y 想7규칙이라는 새로운 규칙 
을 제정하였다. 

이 규칙은 여러가지 요소들의 크기와 배치, 조수의 시작과 마지막 폐지의 모양 및 
매 폐지의 형식이나 부분제목의 설계 등을 정의하고 있다. 그리 복잡한것은 아니지만 
Wizard 97 규칙에는 많은 항목들이 있으므로 이 장에서 모두 설명할수는 없다. 그리하여 
이 장에 서 는 조수의 구성 방법 에 관한 주요항목만을 설명한다. 이 미 설 명한바와 같이 
Windows 2000 에서는 Wizard 97 형식의 조수가 사용되고 있으므로 Windows 2000 용의 
응용프로그람들도 그대로 따라야 한다. Wizard 97 형식의 조수는 Internet Explorer 5.0 
이 상이 설 치 되 여 있는 체 계 라면 실행 할수 있다. 만일 낡은 조작체 계 와 아래 방향호환성 이 
있는 조수를 작성하고 싶다면 ‘^Windows NT 4 Programming From the Ground 
Up”(McGraw Hill ) 또는 “Windows 98 Programming ” 을 참고해 야 한다. 

외부폐지와 내부폐지 

Windows 2000형식의 조수는 외부페지와 내부페지과는 두가지 종류의 패지들로 구성 
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되여 있다. 외부폐지란 조수의 시작과 마감으로 되는 폐지를 말한다. 이 폐지들은 내부페 
지 들 을 둘 러 싸 게 된 다 . 외 부 폐 지 에 는 [ Welcome ] 페 지 와 [ Finish ] 페 지 가 있 다 . 
[ Welcome ] 패 지 는 조수의 개시를 표시 하며 [ Finish ] 폐지는 조수의 완료를 표시 한다. 
[ Welcome ] 폐지의 실례를 그림 13-3 에 주었다. 



내부폐지는 조수에서 실제로 설정을 진행하기 위한 대화칸으로 된다. 머리부의 제목， 
부분제 목 및 비 트매 프도 포함하고 있 다. 내 부폐 지 의 실 례 를 그림 13-4 에 주었 다. 



그림 13-4. Windows 2000의 인쇄기추가 조수의 내부페지 


외부폐지의 구성 

일반적으로 외부페지따는 조종체가 들어 있지 않다. 조수의 시작이나 끝을 보여 주 
는 본문이 표시될뿐이다. [ Welcome ] 폐지에는 두드러지게 강조표시된 제목이 있는것이 
일 반적 이 다. 례 를 들어 만약 로보트의 설정 을 진행하는 조수를 작성한다고 하면 그의 
[ Welcome ] 페 지 에 [Welcome to Robot Setting Wizard (로보트의 설정 조수를 리 용해 주 
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어서 감사합니 다. )] 라는 제 목을 큼직 한 서 체 로 표시 할수 있 다. 

Wizard 97 규칙에 따르면 제목의 서체는 Vernada 의 굵은 체를 사용하며 서체의 크 
기 는 12 포인트로 한다. 그러 나 12 포인트는 대 화단위이 므로 이 값을 화소로 변환하여 야 
한다. (뒤 에서 작성 하게 되 는 프로그람에서 구체 적 인 변환방법 을 보여 준다. ) 제 목은 대 
화단위로 (115,8) 위 치 로부터 표시한다. 시 작점 을 115 만큼 비우는것 은 투명 도안 
( Watermark ) 을 표시 해 야 하기 때 문이 다. 

[ Welcome ] 페 지 에 기 타 주의 사항을 추가하고 나서 마지 막에 [To con 仕 nue , click 
Next (계속하려면《다음으로》를 눌러 주십시오)]와 갈은 문자렬을 표시 한다. 이 본문들 
은 MS Shell Dig 서체，크기는 8 포인트로 한다. 이 서체를 설정하려면 DIALOGEX 명 
령 에 아래의 명 령 문을 포함시킨다. 

FONT 8, “MS Shell Dig” 

제 목이 외 의 본문은 대 화단위 로 (115,40) 의 위 치 로부터 표시한다. 

[ Welcome ] 폐지와 [ Finish ] 폐지로 되는 대화칸의 크기는 317乂 193 으로 한다. 

내부패지의 구성 

내부페지아는 제목, 부분제목 및 비트매프가 들어 있는 머리부령역 이 있다. 이것들 
은 PS 好_的7公4及公…형식 이 설정되면 자동적으로 확보된다. 내부폐지로 되는 대화칸의 
크기는 317，143 으로 하여 야 한다. 이 대화칸에 여 러가지 설정을 진행하는 조종체들을 
배 치 한다. 

대부분의 경우에 내부폐지는 웃부분에 대화단위로 1 만한 너비의 령역을 비우고 측 
면에 대화단위로 12 만한 너비의 령역을 비워 둔다. 수평방향의 령역을 크게 하고 싶다 
면 이 값을 7로 줄일수도 있다. 

매 내 부패 지 의 제 목과 부분제 목은 PROPSHEETPAGE 구조체의 pszHeaderTitle 및 
pszHeaderSubTitle 에 설 정 한 다 . 이 성 원 들을 유 효 하게 하 려 면 형 식 에 PSP _ 
USEHEADERTITLE 기 발과 PSP_USEHEADERSUBTITLE 기 발을 포함시 켜 야 한다. 


투명 도안과 머 리부비 트매 프 

조수의 [ Welcome ] 폐지와 [ Finish ] 폐지의 왼쪽에는 큰 비트매프가 표시된다. 내부 
폐지에서는 이것이 표시되지 않는다. 이 비트매프는 조수의 투명도안으로서의 역할을 수 
행 하며 투명도안 ( Watermark ) 이라고 부른다. 

기술적으로는 특별한 의미가 없는것이지만 Wizard 97 규칙에서는 투명도안욜 리용할 
것 을 강하게 주장하고 있 다. 투명 도안의 크기 는 화소단위 로 164 Z 314 로 한다. 투명 도안 
으로 리 용될 비 트成 뜨는 PROPSHEETHEADER 구조제와 pszbmWatermark 성 원 에 설 정 
한다. 뒤 에서 작성하게 될 실례 프로그람에서 투명 도안으로 리 용되 는 비 트매 프를 작성하 
고 그것 을 BP 1 .BMP 라는 파일 이 름으로 보관해 둔다. 
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머리부비트매프는 내 부패 지 의 머 리부에 표시 된다. 머 리 부비 트매 프의 크기 는 화소단 
위 로 49 Z 49 로 한다. 이 것 도 기 술적 으로는 의 미 가 없는것 이 지 만 Wizar 97 규칙 에 서 강하 
게 주장되 고 있 으므로 머 리부비 트매 프를 반드시 러용해 야 한다. 머 리부비 트매 프는 
PROPSHEETHEADER 구조체의 pszbmHeader 성원에 설정한다. 뒤에서 작성하는 실례 
프로그람에 서 리용할 머 리 부비 트매 프를 작성 하고 그것 을 BP 2 .BMP 라는 파일 이 름으로 
보관해 둔다. 

조수의 단추를 유효상태로 하기 

PSH _ WIZARD 97 기 발을 포함시키면 특성표가 자동적으로 조수형식으로 표시되게 된 
다. 하지만 조수가 원만하게 동작하게 하려면 몇가지 기능을 더 추가하여야 한다. 

우선 프로그람코드에서 단추의 상태를 유효 또는 무효로 설정하여 야 한다. 례를 들 
어 [ Welcome ] 폐 지 에 서 는 [ Next ] 단추를 유효로 하고 [ Back ] 단추를 무효로 한다. 
[ Finish ] 폐지에서는 [ Back ] 단추와 [ Finish ] 단추를 유효로 한다. 

내 부 페 지 에 서 는 [ Next ] 와 [ Back ] 를 유효로 하여야 한다. 그러자면 
PSM _ SETWIZBUTTONS 통 H 을 보내 든가 또는 PropSheet _ SetWizButtons () 마크로를 
사용한다. 이 미 설명 한것 처 럼 PropSheet — SetWizButtons ( ) 의 선언은 아래 와 같이 되 여 
있 다. 


VOID PropSheet _ SetWizButtons ( hPropSheet , Flags ); 

比 PropSheet 는 특성표조종체의 손잡이 이 다. Flags 에는 유효로 하려 는 단추의 종류 
를 설정한다. 설정한 단추만이 유효로 되며 다른 단추는 무효로 된다. 단추의 종류를 가 
리키는 마크로들을 아래에 보여 주었다. 

PSWIZB_BACK PSWIZB—NEXT 

PSWIZB—FINISH PSWIZB_DISABLEDFINISH 

PSWIZB_DISABLEDFINISH 는 무효상태 의 [ Finish ] 단추를 작성 한다. 사용자가 반 
드시 입력해야 하는 항목을 설정하지 않은 경우에는 [ Finish ] 단추를 무효로 한다. 이 마 
크로들을 두개 이 상 OR 연산자로 조합할수도 있다. 실례 로 [ Back ] 단추와 [ Finish ] 단추 
를 유효로 한다면 아래와 같이 설정한다. 


PropSheet_SetWizButtons(PSWIZB_BACK | PSWIZB_FINISH) : 


조수의 실례프로그람 


실례 13-2 의 프로그람은 조수를 작성하는 실 례 프로그람이다. 이 프로그람은 앞에 서 


교육성 프로그람교육멘터 


467 





Windows 2000 프로그람작성법 


설명한 특성표 실례프로그람을 조수로 개조한것이다. 

실 례 13-2. Wiz 프로그람 

// 조수의 실례프로그람 

ttinclude < windows. h> 
ttinclude <cstring> 
ttinclude <cstdio> 


ttinclude <commctrl. h> 

^include ” wiz.h” 

Mefine NUMSTRINGS 5 
ttdefine NUMPAGES 5 

LRESULT CALLBACK WindowFunc (HWND, UINT, WPARAM, LPARAM) ； 
BOOL CALLBACK DialogFuncO (HWND, UINT, WPARAM, LPARAM) ； 
BOOL CALLBACK DialogFuncl(HWND, UINT, WPARAM, LPARAM); 
BOOL CALLBACK DialogFunc2 (HWND, UINT, WPARAM, LPARAM) ； 
BOOL CALLBACK DialogFuncWel(HWND, UINT, WPARAM, LPARAM) ； 
BOOL CALLBACK DialogFuncComp (HWND, UINT, WPARAM, LPARAM) ； 

char szWinNameG = M MyWm”; // 창문클라스의 이름 
HINSTANCE hlnst ； 

HWND hDlg ； // 대화칸의 손잡이 
HPROPSHEETPAGE hPs [NUMPAGES] ； 

HWND hPropSheet ； 

HWND hPage[NUMPAGES ]； 

char list [] [40] = { 

"Windows 2000", 

"Windows NT 4”, 

"Windows 98”, 

"Windows 95”, 

"Windows 3.1" 

}； 


int cbl=0, cb2=0, cb3=0; 
int rbl=l, rb2=0, rb3=0 ； 
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tat lblsel=0 ； 

int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd； 

MSG msg； 

WNDCLASSEX wcl； 

HACCEL hAccel； 

INITCOMMONCONTROLSEX cc； 

// 창문클라스의 정의 

wcl.cbSize = sizeof (WNDCLASSEX) ; 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) : // 큰 아이콘 
wcl. hlconSm = NULL ； // 큰 아이론의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl. IpszMenuName = "PropSheetMenu" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject (WHITE_BRUSH) ; 

// 창문들라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0； 

/* 창문클라스가 등록되였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Demonstrate a Wizard", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CW_USEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
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CWJJSEDEFAULT, // 너 비는 Windows 가 결정하게 한다 . 
CW_USEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 


// 어미창문은 없다 . 

// 차림표는 없다 . 

// 실체의 손잡이 
// 추가파라메 터 는 없 다 . 


NULL, 

NULL, 


hThisInst, 

NULL 


)； 

hlnst = hThisInst ； // 현재의 실체손잡이률 보관한다 . 

// 건반가속기를 적재한다 . 

hAccel = LoadAccelerators (hThisInst, "PropSheetMenu") ； 

// 공통조종체를 초기화한다 . 

cc.dwSize = sizeof (INITCOMMONCONTROLSEX) ； 
cc.dwICC = ICC_TAB_CLASSES; 

InitCommonControlsEx (&cc); 

// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode) ； 

UpdateWindow (hwnd) ； 

// 통보문순환고리률 작성 한다 . 

while(GetMessage(&msg, NULL, 0, 0)) 

{ 

if(! TranslateAccelerator (hwnd, hAccel, 技 msg)) { 
TranslateMessage(&msg) ； // 건반통보를 변환한다 . 
DispatchMessage(&msg) ； // Windows 2000 에 조종을 넘 긴다 . 

} 


return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 


WPARAM wParam, LPARAM IParam) 


470 


int response ； 


교육성 프로그람교육쎈터 



제 13 장. 특성표와 조수 


PROPSHEETPAGE PropSheet [NUMPAGES] ； 

PROPSHEETHEADER PropHdr ； 

switch (message) { 
case WM_CREATE: 
break ； 

case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM_DIALOG: 

PropSheet [0]. dwSize = sizeof (PROPSHEETPAGE) ； 

PropSheet[Ol.dwFlags = PSP.DEFAULT | PSP_HIDEHEADER ； 
PropSheet [0]. hlnstance = hlnst ； 

PropSheet [0]. pszTemplate = "WelcomeDB" ； 

PropSheet [0]. pszlcon = NULL ； 

PropSheet [0]. pfnDlgProc = (DLGPROC) DialogFuncWel ； 
PropSheet [0]. pszTitle = ” 

PropSheet [0]. IParam = 0 ； 

PropSheet [0]. pf nCallback = NULL ； 


PropSheet [1]. dwSize = sizeof (PROPSHEETPAGE) ； 

PropSheet [1]. dwFlags = PSP.DEFAULT | 

PSP.USEHEADERTITLE | 
PSP.USEHEADERSUBTITLE; 

PropSheet [1]. hlnstance = hlnst ； 

PropSheet [1]. pszTemplate = ’’PropSheetDBl”; 

PropSheet [1]. pszlcon = NULL ； 

PropSheet [1]. pf nDlgProc = (DLGPROC) DialogFuncO ； 

PropSheet [1]. pszTitle = ””; 

PropSheet [1]. IParam = 0 ； 

PropSheet [1]. pf nCallback = NULL ； 

PropSheet[1].pszHeaderTitle = "Pick Target”; 

PropSheet [1]. pszHeaderSubTitle = ” Choose a target operating system. M ； 

PropSheet [2]. dwSize = sizeof (PROPSHEETPAGE) ； 

PropSheet [2]. dwFlags = PSP.DEFAULT | 

PSP.USEHEADERTITLE | 
PSP.USEHEADERSUBTITLE : ； 

PropSheet [2]. hlnstance = hlnst ； 

PropSheet [2]. pszTemplate = ” PropSheetDB2”; 
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PropSheet [2]. pszlcon = NULL ； 

PropSheet [2]. pfnDlgProc = (DLGPROC) DialogFuncl ； 

PropSheet [2]. pszTitle = ””; 

PropSheet [2]. IParam = 0 ； 

PropSheet [2]. pf nCallback = NULL ； 

PropSheet [2]. pszHeaderTitle = ’’Choose Options" ； 

PropSheet[2].pszHeaderSubTitle = "Select compilation options.”; 

PropSheet [3]. dwSize = sizeof (PROPSHEETPAGE) ； 

PropSheet [3]. dwFlags = PSP.DEFAULT | 

PSP.USEHEADERTITLE | 
PSP.USEHEADERSUBTITLE; 

PropSheet [3]. hlnstance = hlnst ； 

PropSheet [3]. pszTemplate = ” PropSheetDB3”; 

PropSheet [3]. pszlcon = NULL ； 

PropSheet [3]. pf nDlgProc = (DLGPROC) DialogFunc2 ； 

PropSheet [3]. pszTitle = ””; 

PropSheet [3]. IParam = 0 ； 

PropSheet [3]. pf nCallback = NULL ； 

PropSheet [3]. pszHeaderTitle = ’’Choose Optimizations" ； 
PropSheet [3]. pszHeaderSubTitle = "Determine how to optimize. M 

PropSheet [4]. dwSize = sizeof (PROPSHEETPAGE) ； 

PropSheet [4]. dwFlags = PSP.DEFAULT | PSP.HIDEHEADER ； ； 
PropSheet [4]. hlnstance = hlnst ； 

PropSheet [4]. pszTemplate = ’’CompletionDB"; 

PropSheet [4]. pszlcon = NULL ； 

PropSheet [4]. pf nDlgProc = (DLGPROC) DialogFuncComp; 
PropSheet [4]. pszTitle = 

PropSheet [4]. IParam = 0 ； 

PropSheet [4]. pf nCallback = NULL ； 

hPs [0] = CreatePropertySheetPage (&PropSheet [0]) ； 
hPs[l] = CreatePropertySheetPage (&PropSheet [1]) ； 
hPs [2] = CreatePropertySheetPage (&PropSheet [2]) ； 
hPs [3] = CreatePropertySheetPage (&PropSheet [3]); 
hPs[4] = CreatePropertySheetPage ( 技 PropSheet [4]); 

PropHdr. dwSize = sizeof (PROPSHEETHEADER); 

PropHdr. dwFlags = PSH_WIZARD97 | // 조수로 한다 . 
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PSH.HEADER | 

PSH.WATERMARK ; 

PropHdr. hwndParent = hwnd ； 

PropHdr. hlnstance = hlnst ； 

PropHdr. pszlcon = NULL ； 

PropHdr. pszCaption = 

PropHdr. nPages = NUMPAGES ； 

PropHdr. nStartPage = 0; 

PropHdr. phpage = hPs ； 

PropHdr. pfnCallback = NULL ； 

PropHdr. pszbmWatermark = "wizbmpl"; 

PropHdr. pszbmHeader = ,, wizbmp2" ； 

PropertySheet (技 PropHdr) ； 
break ； 

case IDM_EXIT ： 

response = MessageBox(hwnd, "Quit the Program?", 

” Exit”, MB 一 YESNO); 
if (response == ID YES) PostQuitMessage(O) ； 
break ； 

case IDM_HELP ： 

MessageBox (hwnd, "Try the Wizard", ’’Help”, MB_OK) ； 
break ； 

} 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam); 

} 

return 0 ； 

} 

// 첫번째 대화함수 

BOOL CALLBACK DialogFuncO (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 
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{ 

static long index; 
int i ； 

char str[80] ； 

switch (message) { 
case WM.NOTIFY ： 

switch (((NMHDR *) lParam)->code) { 
case PSN_SETACTIVE ： // 페지가 입 력초점을 엄 었다 . 
hPropSheet = ((NMHDR *) IParam) ->hwndFrom ； 
index = lblsel ； 

PropSheet.SetWizButtons (hPropSheet, PSWIZB.NEXT | PSWIZB.BACK) ； 
SetWindowLong (hdwnd, DWL.MSGRESULT, 0 )； 
return 1; 

case PSN.KILLACTIVE : // 폐지가 입 력초점을 잃었다 . 
lblsel = index; 

SetWindowLong (hdwnd, DWL.MSGRESULT, 0); 
return 1; 

} 

break ； 

case WM.COMMAND ： 
switch (LOWORD (wParam)) { 

case IDD.LBl ： // 목록칸의 LBN_DBLCLK 를 처 러 한다 . 

PropSheet 一 Changed (hPropSheet, hdwnd) ； 

// 사용자가 선택을 진행하였는가를 확인한다 . 
if (HIWORD (wParam) ==LBN_DBLCLK) { 
index = SendDlgltemMessage (hdwnd, IDD_LB1, 

LB_GETCURSEL, 0, 0); // 색인을 얻는다 . 
sprintf(str, ”%s”, list [index]) ； 

MessageBox(hdwnd, str, "Selection Made", MB_OK) ； 

} 

return 1 ； 

} 

break ； 

case WM.INITDIALOG ： // 목록칸을 초기화한다 . 
for(i=0 ； KNUMSTRINGS ； i++) 

SendDlgltemMessage (hdwnd, IDD_LB1, 

LB.ADDSTRING, 0, (LPARAM) list [i]) ； 
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// 첫 항목을 선택한다. 

SendDlgltemMessage (hdwnd, IDD_LB1, LB_SETCURSEL, lblsel, 0); 


return 1； 

} 

return 0； 

} 

// 두번째 대화함수 

BOOL CALLBACK DialogFuncl (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

switch (message) { 
case WM.NOTIFY： 

switch (((NMHDR *) IParam)->code) { 
case PSN.SETACTIVE : // 폐지가 입력 초점을 엄었다. 
hPropSheet = ((NMHDR *) IParam) ->hwndFrom : 
PropSheet_SetWizButtons (hPropSheet, 

PSWIZB.NEXT | PSWIZB_BACK) ； 
SetWindowLong (hdwnd, DWL.MSGRESULT, 0); 
return 1; 

case PSN.KILLACTIVE： // 페 지가 입 력 초점을 잃었 다. 
cbl = SendDlgltemMessage (hdwnd, IDD—CB1, 
BM_GETCHECK, 0, 0); 
cb2 = SendDlgltemMessage (hdwnd, IDD_CB2, 
BM_GETCHECK, 0, 0); 
cb3 = SendDlgltemMessage (hdwnd, IDD—CB3, 
BM.GETCHECK, 0, 0); 

SetWindowLong (hdwnd, DWL.MSGRESULT, 0); 
return 1； 

} 

break； 

case WM.COMMAND： 
switch (LOWORD (wParam)) { 
case IDD_CB1： 
case IDD_CB2： 
case IDD_CB3： 

PropSheet_Changed(hPropSheet, hdwnd); 
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return 1 ； 
case IDD_ALL ： 

PropSheet_Changed (hPropSheet, hdwnd); 
SendDlgltemMessage (hdwnd, IDD_CB1, BM.SETCHECK, 
BST.CHECKED, 0); 

SendDlgltemMessage (hdwnd, IDD_CB2, BM.SETCHECK, 
BST.CHECKED, 0); 

SendDlgltemMessage (hdwnd, IDD_CB3, BM_SETCHECK, 
BST_CHECKED, 0); 

return 1 ； 

} 

break ； 

case WMJNITDIALOG ： // 검 사칸을 초기 화한다. 

SendDlgltemMessage (hdwnd, IDD_CB1, BM_SETCHECK, cbl, 0); 
SendDlgltemMessage (hdwnd, IDD_CB2, BM_SETCHECK, cb2, 0) ； 
SendDlgltemMessage (hdwnd, IDD_CB3, BM_SETCHECK, cb3, 0); 
return 1 ； 


return 0 ； 

} 

// 세번째 대화함수 

BOOL CALLBACK DialogFunc2 (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

switch (message) { 
case WM.NOTIFY ： 

switch (((NMHDR *) IParam)->code) { 
case PSN.SETACTIVE ： // 폐지가 입력초점을 엄었다. 
hPropSheet = ((NMHDR *) IParam) ->hwndFrom : 
PropSheet_SetWizButtons (hPropSheet, 

PSWIZB.BACK | PSWIZB.NEXT) ； 
SetWindowLong (hdwnd, DWL.MSGRESULT, 0); 
return 1 ； 

case PSN.WIZFINISH ： // [Finish] 단추가 눌러웠다. 
case PSN.KILLACTIVE ： // 폐지가 입력초점을 잃었다. 
rbl = SendDlgltemMessage (hdwnd, IDD 一 RBI, 
BM.GETCHECK, 0, 0); 
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rb2 = SendDlgltemMessage (hdwnd, IDD_RB2, 

BM.GETCHECK, 0, 0); 
rb3 = SendDlgltemMessage(hdwnd, IDD_RB3, 

BM_GETCHECK, 0, 0); 

SetWindowLong (hdwnd, DWL.MSGRESULT, 0)； 
return 1; 

} 

break； 

case WM.COMMAND： 
switch (LOWORD (wParam)) { 
case IDD_RB1 : 
case IDD_RB2: 
case IDD 一 RB3: 

PropSheet 一 Changed (hPropSheet, hdwnd) ； 
return 1; 

case IDD_FASTEST: 

PropSheet_Changed (hPropSheet, hdwnd) ； 

SendDlgltemMessage (hdwnd, IDD.RB2, BM.SETCHECK, 0, 0) 
SendDlgltemMessage (hdwnd, IDD.RB3, BM.SETCHECK, 0, 0) 
SendDlgltemMessage (hdwnd, IDD.RB1, BM.SETCHECK, 1, 0) 
return 1; 

case IDD 一 SMALLEST: 

PropSheet_Changed(hPropSheet, hdwnd) ； 

SendDlgltemMessage (hdwnd, IDD_RB1, BM.SETCHECK, 0, 0) 
SendDlgltemMessage (hdwnd, IDD.RB2, BM.SETCHECK, 0, 0) 
SendDlgltemMessage (hdwnd, IDD.RB3, BM.SETCHECK, 1, 0) 
return 1； 

} 

break； 

case WM.INITDIALOG： // 단일선택 단추를 초기 화한다. 
SendDlgltemMessage (hdwnd, IDD_RB1, BM_SETCHECK, rbl, 0); 
SendDlgltemMessage (hdwnd, IDD_RB2, BM_SETCHECK, rb2, 0); 
SendDlgItemMessage(hdwnd, IDD_RB3, BM.SETCHECK, rb3, 0)； 
return 1； 

} 

return 0； 

} 
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// [Welcome] 대화칸 

BOOL CALLBACK DialogFuncWel (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

PAINTSTRUCT ps ； 

HDC dc ； 

static HFONT hFontTitle ； 

static char *welcomeStr = "Welcome to the Wizard" ； 

RECT r ； 


switch (message) { 
case WM.PAINT: 
dc = BeginPaint(hdwnd, 技 ps); 
r. right = 115; r. bottom = 8; 

MapDialogRect(hdwnd, &r)； // 화소단위로 변환한다. 
SelectObject(dc, hFontTitle) ； // 큰 서체를 선택한다. 
TextOut(dc, r. right, r. bottom, welcomeStr, 
strlen (welcomeStr)) ； 

EndPaint (hdwnd, &ps) ； 
break ； 

case WM.NOTIFY ： 

switch (((NMHDR *) IParam)->code) { 
case PSN.SETACTIVE : // 폐지가 입력 초점을 엄었다. 
r. bottom = 12； 

MapDialogRect(hdwnd, &r) ； // 화소단위로 변환한다. 

// 조수제목을 위한 서체를 작성한다. 

hFontTitle = CreateFont(r. bottom, 0, 0, 0, FW_MEDIUM, 
0, 0, 0, ANSI.CHARSET, 
OUT_DEFAULT_PRECIS, 
CLIP_DEFAULT_PRECIS, 
DEFAULT.QUALITY, 

DEFAULT-PITCH | FF.DONTCARE, 

” Verdana ，，); 

hPropSheet = ((NMHDR *) IParam)->hwndFrom； 
PropSheet_SetWizButtons (hPropSheet, 

PSWIZB_NEXT) ； 

SetWindowLong (hdwnd, DWL.MSGRESULT, 0 )； 
return 1 ； 
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case PSN.KILLACTIVE : // 폐지 가 입 력 초점을 잃었 다 . 
SetWindowLong (hdwnd, DWL.MSGRESULT, 0 )； 
DeleteOb ject (hFontTitle); 
return 1 ； 

} 

break ； 


return 0 ； 

} 

// [Finish] 대화칸 

BOOL CALLBACK DialogFuncComp (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

PAINTSTRUCT ps ； 

HDC dc ； 

static HFONT hFontTitle ； 

static char *compStr = "Completing the Wizard." ； 

RECT r ； 

switch (message) { 
case WM.PAINT ： 
dc = BeginPaint (hdwnd, &ps); 
r.right = 115 ； r. bottom = 8 ； 

MapDialogRect(hdwnd, &r) ； // 화소단위로 변환한다 . 
SelectObject(dc, hFontTitle) ； // 큰 서체를 선택한다 . 
TextOutCdc, r. right, r. bottom, compStr, 
strlen (compStr)) ； 

EndPaint (hdwnd, &ps) ； 
break ； 

case WM.NOTIFY ： 

switch (((NMHDR *) IParam)->code) { 
case PSN_SETACTIVE : // 폐지가 입력 초점을 엄었다 . 
r. bottom = 12 ； 

MapDialogRect(hdwnd, &r) : // 화소단위 로 변환한다 . 

// 조수제목을 위한 서체를 작성한다 . 

hFontTitle = CreateFont(r. bottom, 0, 0, 0, FW_MEDIUM, 
0, 0, 0, ANSI.CHARSET, 
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OUT_DEFAULT_PRECIS, 
CLIP_DEFAULT_PRECIS, 
DEFAULT-QUALITY, 
DEFAULT.PITCH | FF.DONTCARE, 
” Verdana”) ； 

hPropSheet = ((NMHDR *) IParam) ->hwndFrom ； 
PropSheet_SetWizButtons(hPropSheet, 

PSWIZB_BACK I PSWIZB_FINISH); 
SetWindowLong (hdwnd, DWL.MSGRESULT, 0 )； 
return 1; 

case PSN.KILLACTIVE : // 폐지가 입 력초점을 잃었다 . 
SetWindowLong (hdwnd, DWL.MSGRESULT, 0 )； 
DeleteOb ject (hFontTitle); 
return 1 ； 

} 

break ； 

} 

return 0 ； 

} 


이 프로그람은 아래와 같은 자원파일을 필요로 한다. 두개의 비트매프가 추가된 점 
에 주의 를 돌려 야 한다. 이 미 설 명한바와 같이 BP 1 .BMP 는 투명 도안으로 되 며 
BP 2 .BMP 는 머리부비트매프이다. 프로그람을 번역하기전에 이 비트매프들을 미리 작성 
하여 야 한다. 


// 조수의 자원파일 
#include < windows. h> 
^include <commctrl. h> 
#include "wiz.h" 
wizbmpl BITMAP bpl.bmp 
wizbmp2 BITMAP bp2.bmp 
PropSheetMenu MENU 
{ 

POPUP M &Wizard Demo” 

{ 
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MENUITEM M E&xit\ tCtrl+X”, IDM—EXIT 

} 

MENUITEM "&Help”, IDM.HELP 

} 

PropSheetMenu ACCELERATORS 

{ 

VK_F2, IDM_DIALOG, VIRTKEY 
VK 一 FI, IDM_HELP, VIRTKEY 
『 X", IDM.EXIT 

} 

WelcomeDB DIALOGEX 0, 0, 317, 193 
CAPTION ” Compilation Options Wizard” 

FONT 8, ” MS Shell Dig” 

{ 

LTEXT "To continue, click Next.”, IDD.STEXT2, 115, 40, 100, 14 

} 

PropSheetDBl DIALOGEX 0, 0, 317, 143 
CAPTION ” Compilation Options Wizard” 

FONT 8, ” MS Shell Dig” 

{ 

CTEXT ’’Choose Target OS”, IDD 一 STEXT1, 21, 1, 60, 14 
LISTBOX IDD_LB1, 21, 24, 60, 52, LBS—NOTIFY | 

WS_BORDER | WS 一 VSCROLL | WS 一 TABSTOP 

} 

PropSheetDB2 DIALOGEX 0, 0, 317, 143 
CAPTION "Compilation Options Wizard” 

FONT 8, ” MS Shell Dig” 

{ 

DEFPUSHBUTTON M A11 M , IDD_ALL, 21, 1 ， 34, 14 
AUTOCHECKBOX "Check for stack overflows. M , IDD_CB1, 

21, 31, 92, 10 

AUTOCHECKBOX "Check array boundaries. M , IDD_CB2, 

21, 51, 92, 10 

AUTOCHECKBOX "Prevent assignment to null.”, IDD.CB3, 
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21 ， 71, 100, 10 

} 

PropSheetDB3 DIALOGEX 0, 0, 317, 143 
CAPTION ” Compilation Options Wizard” 

FONT 8, "MS Shell Dig ，， 

{ 

DEFPUSHBUTTON ” Fastest”, IDD.FASTEST, 21, 1, 34, 14 
PUSHBUTTON ” Smallest”, IDD 一 SMALLEST, 21, 25, 34, 14 
AUTORADIOBUTTON "Optimize for speed.", IDD.RB1, 

66, 1, 90, 10 

AUTORADIOBUTTON "Balance speed and size.”, IDD_RB2, 

66, 21, 90, 10 

AUTORADIOBUTTON "Optimize for size.”, IDD_RB3, 

66, 41, 90, 10 

} 

CompletionDB DIALOGEX 0, 0, 317, 193 
CAPTION "Compilation Options Wizard” 

FONT 8,，，MS Shell Dig” 

{ 

LTEXT "To close, click Finish.，’, IDD_STEXT3, 115, 40, 100, 14 

} 

머 리 부파일 WIZ.H 의 내 용을 아래 에 보여 주었 다. 


ttdefine IDM_DIALOG 100 

#define IDM.EXIT 101 

#define IDM.HELP 102 

#define IDD_OPTIONS 201 

#define IDD_OPTIMIZE 202 

Mefine IDD_FASTEST 204 

#define IDD_SMALLEST 205 

#define IDD_ALL 207 

#define IDD_LB1 301 
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ttdefine IDD.EB1 401 

#define IDD_CB1 501 

Mefine IDD_CB2 502 

#define IDD_CB3 503 

Mefine IDD_RB1 601 

#define IDD_RB2 602 

#define IDD_RB3 603 

#define IDD_STEXT1 700 

#define IDD_STEXT2 701 

#define IDD_STEXT3 702 


프로그람의 실행결과를 그림 13-5 에 보여 주었다. 
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ai 13-5. 조수의 yassnii 의 실행결과 

조수실례프로그람의 상세 

조수실례프로그람의 많은 부분은 특성표 실례프로그람과 갈다. 그러나 일부 변경된 
부분도 있다. 

우선 PropHdr 구조체의 dwFlags 성원에 PSH _ WIZARD 97 기발이 추가된 점에 주목해 
야 한다. 이미 설명한것처럼 이 기발은 특성표를 최신형식의 조수로 변환한다. PropHdr 
구조체 에는 필요한 기 발들과 함께 투명도안과 머 리부비트매프도 추가되 여 있다. 

Wizard 97 규칙에 따라 자원파일에 [ Welcome ] 대화칸과 [ Finish ] 대화칸이 추가되여 
있고 그것들의 대화함수가 프로그람에 추가되여 있다. 이 프로그람에서는 조수를 실현하 
는데 필요한 대 화칸의 수가 세 개 가 아니 라 다섯개 로 되 여 있으므로 NUMPAGES 마크로 
의 수를 5로 변경하였 다. 

[ Welcome ] 대 화 칸과 [ Finish ] 대 화 칸의 대 화 함수는 각각 DialogFuncWeK ) 및 
DialogFuncComp ( ) 이다. 앞에서 본 프로그람의 대화칸에 정의되여 있던 여러가지 조 
종체들이 내부폐지에서 사용되고 있으나 그것들의 위치는 Wizard 97 규칙에 맞추어 변경 
되였다. 

이 프로그람에서는 새로운 폐지가 능동상태로 되면 적절한 단추들만을 유효로 하고 
있다. 필요에 따라 [ Back ], [ Next ] 및 [ Finish ] 단추를 유효로 하고 있다. 그것을 실현 
하기 위 한 프로그람코드가 WM_NOTIFY 통보문을 처 리 하는 부분에 추가되 여 있 다. 

조수의 매 폐지는 순서대 로 표시되 여 야 하므로 [Pick Target ] 폐지의 [ Options ] 단추 
와 [ Optimize ] 단추가 삭제되여 있다. 조수를 사용할 때 순서를 무시하여 패지를 능동으 
로 하는것은 Windows 2000의 정확한 형식이 아니다. 
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제 13 장. 특성표와 조수 


[Welcome] 폐지와 [Finish] 폐지에 제목을 표시하기 

이미 설명한것처럼 내부폐지의 제목은 대화단위로 12 포인트，굵은체， Verdana 서체 
로 한다. 대 화단위 를 화소로 변환하려 면 MaDDialogRect ( ) 힘今를 사용한다. 아래 에 선 
언을 보여 주었다. 


BOOL MapDialogRect (HWND hDialog, RECT *rect) : 


tiDialog 에 대화칸의 손잡이를 설정한다. 화소단위로 변환하기전의 크기를 rect 구조 
체에 설정한다. 함수의 호출이 성공한 경우는 령 아닌 값이 돌려 지며 실패한 경우에는 
령이 돌려 진다. 

대화단위의 12 를 화소로 변환하려면 RECT 구조체의 bottom 성원에 12 를 설정한 다 
음 MapDialogRect ( )를 호출한다. 같은 rect 구조체의 bottom 성원에 화소단위로 변환 
된 크기가 돌려 진다. 이 값은 제목을 위한 서체의 크기를 설정하는데 사용된다. 

제 목을 위한 서체 가 외부폐지 가 능동으로 될 때 마다 작성되 고 페 지 가 바껄 때마다 
파괴되고 있는 점에도 주의를 돌려야 한다. 이러한 처리가 필요한것은 서체가 필요 없게 
되면 해제해야 하는 자원이기때문이다. 

대화단위로부터 화소에로의 변환은 제목이 표시될 때도 진행되여야 한다. 이미 설명 
한바와 같이 제목은 대화단위로 (115,8) 의 위치에 표시된다. 이 프로그람에서는 다시 한 
번 MapDialogRect ( )를 사용하여 이 위치를 화소로 변환하고 있다. 

노력한것만한 가치가 있다 


특성 표와 조수는 Windows 2000 응용프로그람에 세 련된 조작성 을 제 공해 준다. 이 것 
들을 작성하려면 약간한 품이 들지만 복잡한 입력과정을 인도하여 주므로 노력한것만한 
가치가 있는것이다. 

특히 조수를 사용하면 한개의 입력화면으로는 표시할수 없는 복잡한 항목들을 설정하 
는 경우에도 그것을 사용자에게 알기 쉽게 제공할수 있다. 이제는 조수의 작성방법을 정 
통하였으므로 그것을 복잡한 입 력처 리가 요구되는 장면들에서 능히 활용할수 있을것 이 다. 
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머 리부조종체와 월사업 표조종체 


이 장에 서 는 머 리 부조종체 와 월 사업 표조종체 라는 두가지 공통조종제악 
사용방법에 대하여 설명한다. 

머 리부조종체는 렬머 리부들의 띠로 구성되여 있으며 표형식으로 정보 
를 표시 할 때 사용된다. 월사업 표조종체는 비 교적 새로운 조종체로서 달력 
을 표시하고 날자를 선택할수 있게 되여 있다. 월사업표조종체는 실물의 
달력과 비슷한 모양을 가전다. 



제 14 장. 머 리 부조종체 와 월 사업표조종체 


머 리 부조종체 


머리부조종제는 렬머 리 부로 구성 된 띠 이 다. Windows 2000 을 사용하고 있 다면 반드 
시 머리부조종체를 본적이 있을것이다. 례를 들어 탐색기에서는 파일의 구체적인 정보를 
표시하는 부분에서 머 리부조종체가 사용되고 있다. 그러 나 머 리부조종체는 단순히 정보 
를 표시 하기 만 하는것 이 아니 라 사용자가 매 개 렬의 크기를 변경 할수 있으며 마우스의 
찰칵에 응답할수도 있다. 머리부조종체는 여러가지 장면에서 활용할수 있는 공통조종체 
이며 정보를 렬형식으로 표시하여 관리하기 위한 표준적 인 기능들을 제공해 준다. 

머리부조종체의 작성 

머 리 부조종체 는 창문콜라스에 WC—HEADER 를 지 정 하고 CreateWindow ( ) 혹은 
CreateWindowEx ( ) 를 호출하여 작성된다. 그때 형식에 WS_CHILD 를 포함시킨 다. 

일반적 으로 머 리부조종체를 작성할 때는 너 비와 높이 를 령 으로 해둔다. 그 리유는 
프로그람이 실행될 때 머리부조종체의 크기를 어미창문의 의뢰자구역에 맞추어 조정해야 
하기 때문이다. 

또한 현재 선택되여 있는 서체의 크기에도 맞추어야 한다. 다행히 머리부조종체에는 
그것이 작성된후에 크기를 변경시키는 기능이 갖추어 져 있으므로 수동적으로 크기를 조 
정할 필요는 없다. 

머 리부조종체 의 크기 는 그것 이 작성 된후부터 조정 하기때 문에 대 부분의 머 리부조종체 
의 작성은 아래와 같이 CreateWindow ( ) 를 사용하여 진행한다. 

hHeadWnd = CreateWindow (WC_HEADER, NULL, 

WS_CHILD | WS_BORDER, 

CW_USEDEFAULT, CW_USEDEFAULT, 

0, 0, hParent, 

(HMENU) ID_HEADCONTROL, 
hlnst, NULL) ； 

比 Parent 에는 어미창문의 손잡이를 설정한다. hlnst 에는 응용프로그람의 실체손잡이 
를 설정한다. ID_HEADCONTROL (이 값은 임의로 설정한다.)은 머리부조종체의 ID 이 
다. 크기 를 0으로 하였 으므로 초기 에 는 머 리 부조종체 가 표시 되 지 않는다. 

체계설정의 머리부조종체는 표식과 경계선만으로 구성되게 된다. 그러나 머리부조종 
체 를 작성 할 때 에 //公 S _ 요 C /7 T 幻 A 校 형 식 을 포함시 키 면 누름단추로 구성 된 머 리 부항목을 
작성할수 있 다. 이 기 능을 사용한 실 례 프로그람은 이 장의 뒤 부분에 서 소개한다. 


교육성 프로그람교육멘터 


487 




Windows 2000 프로그람작성 법 


작성직후의 머리부조종체는 비여 있는 상태로 되여 있다. 매 머리부항목의 내용은 
각각 추가하여 야 한다. 조종체의 크기를 어미창문의 크기 에 맞추는것도 필요하게 된다. 

이 려한 리유로부터 작성 직후의 머 리부조종체는 비표시상태로 해 두어 야 하는것 이다. 
머리부항목의 설정과 크기의 조정이 끝난 다음에 머리부조종체를 표시한다. 그러므로 머 
리부조종체를 사용하기 위한 절차는 다음과 같이 된다. 

• 머리부조종체의 적절한 크기를 결정하고 그 크기를 설정한다. 

• 머리부조종체의 매 머리부항목을 추가한다. 

• 머 리 부조종체 를 표시 한다. 

이 러한 절차를 실행하려면 뒤 에서 설명 하는 여 러 가지 통보문들을 머 리부조종체 에 보 
내 야 한다. 

머리부조종체에 롬보문을 보내기 

머 리부조종체는 여 러 가지 통보문에 응답한다. 흔히 사용되는 통보문들을 표 14-1 에 
보여 주었다. 머 리부조종체 에 통보문을 보내 려면 통보문을 받는 측으로 머 리부조종체의 
손잡이를 지정하여 SendMessage( )를 호출한다. 통보문을 보내는 처리를 쉽게 하기 위 
한 마크로들도 제공되고 있다. 표 14-1 에 보여 준 통보문들에 대응하는 마크로를 아래 
에 보여 주었다. 


BOOL Header_DeleteItem(HWND hHeadWnd, int index); 


BOOL Header_GetItem (HWND hHeadWnd, int index, 
HDITEM *HdItemPtr); 


int Header_GetItemCount (HWND hHeadWnd) : 

int Headerjnsertltem (HWND hHeadWnd, int index, 

HDITEM *HdItemPtr); 

BOOL Header_Layout (HWND hHeadWnd, HDLAYOUT *LayoutPtr) : 

BOOL Header_SetItem (HWND hHeadWnd, int index, 

HDITEM *HdItemPtr) : 

모든 마크로에 있어서 hHeadWnd 에는 머리부조종체의 손잡이를 설정하고 index 에 
는 처리대상으로 되는 항목의 색인을 설정한다. HdltemPtr 는 /及? /7EM 구조체의 지시자 
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이 다. LayoutPtr 는 //必五고 FDt/r 구조체 의 지 시 자이 다. 이 구조체 들은 머 리 부조종체 의 
작성이나 조작에 있어서 특히 중요한것들이므로 상세하게 설명한다. 


표 14-1. 머리부조종체의 주요한 통보문 




HDM_DELETEITEM 

머리부항목을 삭제한다. 호출이 성공한 경우는 
령 아닌 값을 돌려 주며 실패한 경우 령을 돌려 준 
다. wParam 에 머 리 부항목의 색 인을 설정한다. 
IParam 에 는 령 을 설정 한다. 

HDM_GETITEM 

머리부항목의 정보를 얻는다. 호출이 성공한 경 
우는 령 아닌 값을 돌려 주며 실패한 경우 령을 돌 
려 준다. wParam 에는 머리부항목의 색 인을 설정 
한다. IParam 에는 엄은 정 보를 보관하기 위한 
HDITEM 구조체 의 지 시 자를 설 정한다. HDITEM 
구조체의 성원 mask 의 값은 엄은 정보를 식별하는 
것으로 된다. 

HDM.GETITEMCOUNT 

머리부항목의 수를 돌려 준다. 호출이 성공한 경 
우는 -1 을 돌려 준다. wParam 과 IParam 에 는 령 
을 설정 한다. 

HDM-HITTEST 

점의 자리표를 보내면 그 위 치의 머 리부항목의 
색인이 돌려 진다. 지정된 점이 머리부항목의 내부 
에 있지 않는 경우는 -1 이 돌려 진다. wParam 에 
는령을 설정 한다. IParam 에는 점을 지정 하는 
HDHITTESTINF ◦ 구조체의 지시 자를 설정 한다. 

HDMJNSERTITEM 

머 리 부항목을 삽입한다. 호출이 성 공한 경 우는 
삽입 된 머 러 부항목의 색 인이 돌려 지 고 실패한 경 
우는 -1 이 돌려 진다. wParam 에는 그후에 새 로운 
머 리 부항목을 삽입할 색 인을 설 정한다. 선두에 머 
러부항목을 삽입하는 경 우는 색 인에 령 을 설정한 
다. 끝에 머 리부항목을 삽입하는 경우는 현재의 머 
리부조종체 에 존재하는 머 리부항목의 수보다 큰 값 
을 색 인으로 설정한다. IParam 에는 새로 삽입할 
머 리 부항목의 정 보를 포함한 HDITEM 구조체 의 지 
시자를 설정한다. 

HDM_LAYOUT 

어미창문의 의뢰자구역의 크기를 보내면 그에 맞 
는 적절한 머 리부조종체의 크기 가 얻 어 진다. 호출 
이 성공한 경우에는 령 아닌 값이 돌려 지며 실패 
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한 경우는 령 이 돌려 진다. wParam 에는 령을 설 
정 한다. IParam 에는 HDLAYOUT 구조체 의 지시 
자를 설정 한다. HDLAYOUT 구조체의 prc 성 원에 
어 미 창문의 의 뢰 자구역 의 크기 를 설 정한다. 돌림 값 
으로서 HDLAYOUT 구조체의 pwpos 성 원에 머 리 
부조종체의 적절한 크기가 돌려 전다. 

HDM—SETITEM 

머 리 부항목에 정 보를 설 정한다. 호출이 성 공한 
경우는 령 아닌 값이 돌려 지며 실패한 경우에는 
령 이 돌려 진다. wParam 에는 머 리부항목의 색 인 
을 설정 한다. IParam 에 는 머 리 부항목의 정 보를 보 
관한 HDITEM 구조체 의 지 시 자를 설 정 한다. 
HDITEM 구조체의 성원 mask 에는 설정하는 정보 
를 식 별하는 값을 설정한다. 


HDITEM 구조체 

머리부조종체의 매 머리부항목은 아래에 보여 준 //幻 /7 EM 구조체에서 정의된다. 

typedef struct _HDITEM 
{ 

UINT mask ； 
int cxy; 

LPSTR pszText; 

HBITMAP hbm ； 
int cchTextMax ； 
int fmt; 

LPARAM IParam ； 
int ilmage ； 
int iOrder; 

UINT type ； // Windows 2000 에 새 롭게 추가된것 
LPVOID pvFilter ； // Windows 2000 에 새 롭게 추가된것 
} HDITEM ； 

mask 의 값은 HDITEM 구조체의 어느 성원에 정보가 들어 있는가를 표시한다. 이것 
은 아래에 보여 준 값들의 조합으로 된다. 
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HDI_BITMAP 

hbm 에 비 트매 프의 손잡이 가 보관되 여 있 다. 

HDI—FILTER 

type 및 pvFilter 에 정 보가 보관되 여 있 다. (Windows 
2000 에 새 롭게 추가된것 ) 

HDI FORMAT 

fmt 에 양식 기 발이 보관되 여 있 다. 

HDI HEIGHT 

cxy 에 머 리 부항목의 높이 가 보관되 여 있 다. 

HDLWIDTH 

cxy 에 머 리 부항목의 너 비 가 보관되 여 있 다. 

HDI—LPARAM 

lParam 에 는 정 보가 보관되 여 있 다. 

HDI—TEXT 

pszText 및 cchTextMax 에 정보가 보관되여 있다. 

HDIJMAGE 

ilmage 에 정 보가 보관되 여 있 다. 

HDLORDER 

iOrder 에 정 보가 보관되 여 있 다. 


cxy 에는 mask 의 값이 HDI_WIDTH 와 HDI_HEIGHT 가운데 어느것 인가에 따라 
머리부항목의 너비 또는 높이를 설정한다. 

pszText 에 는 렬의 표식 으로 되 는 문자렬의 지 시 자를 설정한다. 이 문자렬의 길 이 
는 cchTextMax 에 설 정한다. 

머 리 부항목에 비 트매 프를 표시 하는 경 우에 는 hbm 에 비 트매 프의 손잡이 를 설정 한다. 
fmt 에 설정되는 값은 머리부항목을 표시할 때의 형식을 가리킨다. 이것은 아래에서 보 
여 주는 값과 배치를 나타내는 값의 조합으로 된다. 


HDF—STRING 

머 러부항목에 문자렬을 표시한다. 

HDF—BITMAP 

머 려부항목에 비트매프를 표시한다. 

HDF BITMAP ON RIGHT 

비트매프를 본문의 오른쪽에 표시한다. 

HDF—OWNERDRAW 

소유자그리기로 한다. 


배치를 가리키는 값을 아래에 보여 주었다. 


HDF LEFT 

왼쪽맞추기 

HDF CENTER 

가운데 맞추기 

HDF RIGHT 

오른쪽맞추기 


lParam 에 는 응용프로그람자체 의 자료를 설정 할수 있 다. 

머 리부항목에 화상목록을 포함시키는 경우는 화상의 색 인을 ilmage 에 설정 한다. 그 
리나 이 장의 실례프로그람에서는 화상목록을 사용하지 않는다. 

머리부항목의 정보를 얻을 때는 iOrder 에 머리부항목의 위치를 (0 을 시작점으로 하 
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여 왼쪽에서 오른쪽의 순서로) 설정한다. 

type 와 pvFilter 는 Windows 2000 에서 새 롭게 추가된것 이 다. 이 성 원들은 자료의 
선별기를 작성하는데 사용된다. 그러나 이 장의 실례프로그람에서는 사용되지 않는다. 


이식과 관련한 요점 : HDITEM 구조체를 이전에는 HDJTEM 구조체라고 불렀다. 


HDLAYOUT 구조체 

//幻도구조체 는 머 리 부조종체 의 적 절한 크기 를 얻 기 위 해 HDM—LAYOUT 
통보문과 함께 사용된 다. 이 경 우는 머 리 부조종체 의 어 미 창문의 의 뢰 자구역 의 직 4각형 
크기를 주는것이 일반적이다. HDLAYOUT 구조체의 정의를 아래에 보여 주었다. 

typedef struct _HDLAYOUT 
{ 

RECT *prc ； 

WINDOWPOS *pwpos ； 

} HDLAYOUT ； 


prc 에 머리부조종체가 표시되는 령역의 크기를 가리키는 RECT 구조체의 지시자를 설 
정한다. 머리부조종체가 크기를 계산하고 지정된 령역에 맞는 적절한 크기를 결정한다. 
계산된 크기 는 pwpos 가 가리 키는 WINDOWSPOS 구조체의 지시 자에 돌려 전다. RECT 
구조체에 대해서는 이미 알고 있다. 竹7八取 O 竹 PQS 구조체의 정의를 아래에 보여 주었다. 

typedef struct tagWINDOWPOS { 

HWND hwnd ； 


HWND hwndlnsertAfter ； 
int x; 
int y ； 
int cx ； 


int cy ； 

UINT flags ； 

} WINDOWPOS ； 

hwnd 는 머 리부조종체의 손잡이 이다. hwndlnsertAfter 는 公; TA ?// (화면에서 창문들 
이 놓이는 순서)에서 하나밑 에 있는 창문의 손잡이 이다. 창문의 왼쪽 웃모서 리의 자려 표 
가 x 와 y 에 보관된다. cx 에 너비가 보관되고 cy 에 높이가 보관된다. flags 의 값은 창 
문과 관련되는 여 러 가지 속성들을 지 시 한다. 이 장에서 는 WINDOWPOS 구조체를 머 리 
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부조종체 에 초기 화된 그대 로의 상태 로 사용한다. 구조체의 내 용을 변경할 필요는 없 다. 


이식과 관련한 요점 : HDLAYOUT 구조체를 전에는 HD_LAYOUT 라고 불렀다. 


머 리부의 크기변경 

초기화가 끝난 머 리부조종체의 크기를 조정 하려면 HDM_LAYOUT 통보문을 보낸 
다 . ( 또는 Header _ Layout ( ) 마크로를 사용한다. ) 이 통보문에 대 한 응답으로서 돌려 진 
크기나 위치를 리용하여 머리부조종체의 크기를 조정한다. 다음에 실례를 보여 주었다. 


RECT rect ； 
HDLAYOUT layout ； 
WINDOWPOS winpos ； 


// 어미창문의 크기를 얻는다 . 


GetClientRect (hParent, &rect) : 


//의뢰 자구역 에 맞춘 머 리부조종체의 크기를 엄는다 . 
layout, pwpos = 技 winpos; 
layout, prc = &rect ； 

Header_Layout (hHeadWnd, &layout); 


// 의뢰자구역에 맞추어 머리부조종체의 크기를 변경한다 . 
MoveWindow(hHeadWnd, winpos. x, winpos. y, 
winpos. ex, winpos. cy, 0); 


우선 GetClientRect () 를 호출하여 머리부조종체를 표시하는 창문의 크기를 엄는다. 
다음 이 크기를 Header _ Layout ( )를 사용하여 머리부조종체에 통지 한다. 돌림 값으로서 
pwpos 성원에 머 리부조종체의 적절한 크기와 위 치가 돌려 진다. 이 값들을 파라메 터로 
MoveWindow ( )를 호출하여 머 리부조종체의 크기 와 위 치를 설정 한다. 

哲]을 참고할것) 

이미 설명한것처럼 이 시점에서는 아직 머리부조종체가 표시되지 않는다. 머리부항 
목을 삽입 하고 나서 머 리부조종체를 표시한다. 


주어 1 

因田11 
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I 다시 한보 전진| 


창문으 I 이동 

창문의 위치나 크기를 변경시키기 위하여 MoveWindow( ) 라는 API 함수를 
사용한다. 아래에 선언을 보여 주었다. 

BOOL MoveWindow (HWND hwnd, int NewX, int NewY, 

int NewWidth, int NewHeight, BOOL Repaint) : 

hwnd 에 처 리대상으로 되는 창문의 손잡이를 설정한다. 새로 이동할 왼쪽웃 
모서 리 의 자리 표를 NewX 와 NewY 에 설 정 한다. 새 로운 너 비 와 높이 를 
NewWid 比 i 와 NewHeight 에 설 정 한다. Repaint 에 령 아닌 값을 설정 하면 위 치 
나 크기를 변경한후에 창문이 곧 다시그리기된다. 그렇지 않은 경우에는 다시그 
리기요구가 창문의 통보문렬에 보관되고 후에 처리된다. Afoye 竹公는 호출 
이 성 공하면 령 아닌 값을 돌려 주고 실패하면 령 을 돌려 준다. 

MoveWindowC) 를 사용하면 창문의 크기와 위치를 변경시킬수 있다. Z 차례 
(창문이 놓이는 순서)를 변경할수는 없다. 창문의 Z 차례를 변경하려는 경우에는 
SetWindowPos ( 사용한다. 아래 에 선언을 보여 주었 다. 

BOOL SetWindowPos (HWND hwnd, HWND hWhere, 

int NewX, int NewY, int NewWidth, 
int NewHeight, UINT How) : 

hwnd 에 처리의 대상으로 되는 창문의 손잡이를 설정한다. hWhere 에는 
창문의 Z 차례를 설정한다. hWhere 에는 hwnd 에서 지정된 창문의 밑에 놓이는 
창문의 손잡이 혹은 Z 차례의 절대위 치를 가리키는 값을 설정 한다. 

실례로 hwnd 에서 지정된 창문을 제 일 우에 배 치하려면 HWND_TOP 를 설 
정한다. 창문을 제 일 밑 에 배 치 한다면 HWND_BOTTOM 을 설정 한다. 왼쪽웃모 
서리의 자리 표를 NewX 와 NewY 에 설정 한다. 새로운 너비와 높이를 
NewWid 比! 와 NewHeight 에 설정 한다. 

How 의 값은 창문의 위 치 를 변경 할 때 의 상태 를 지 정 한다. 실 례 로 
SWP_HIDEWINDOW 라면 창문이 비 표시 로 되 며 WSP_SHOWWINDOW 라면 창 
문이 표시된다. SetWindowPos ( ) 는 호출이 성공하면 령 아닌 값을 돌려 주고 
실패하면 령 을 돌려 준다. NewX 와 NewY 에 설정 한 자리 표는 창문이 제 일 웃준 
위의 창문인가 새끼창문인가에 따라 다른 의미를 가전다. 새끼창문의 경우는 어 
미창문의 의뢰자구역에 대한 자리표로 된다. 제일 웃준위의 창문인 경우는 화면 
에 대 한 자리표로 된다. 

MoveWindow( ) 와 SetWindowsPos () 는 편리한 함수로서 그것들을 활용하 
여 프로그람작성에서 제기되는 여러가지 문제들을 해결할수 있다. 
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머리부조종체에 머리부항목들 삽입하기 

머 려부조종체 에 적절한 크기를 설정해 주면 거기 에 머리부항목을 삽입할수 있다. 매 
머 리 부항목은 한개 의 렬 을 정 의 하게 된 다. 머 리 부항목을 삽입 하려 면 먼 저 HDITEM 구조 
체에 머 리부항목의 정보를 설정하고 다음 Headerlnsertltem ( ) 함수를 호출한다. 

례를 들어 아래의 프로그람코드는 머리부조종체의 첫렬로 되는 머리부항목을 삽입하 
는 코드이 다. 

HDITEM hditem ； 


hditem. mask = HDI_FORMAT | HDI_WIDTH | HDI_TEXT ； 

hditem. pszText = “Heading #1”; 

hditem. cchTextMax = strlen (hditem. pszText) : 

hditem. cxy = 100 ； 

hditem. fmt = HDF_STRING | HDF_LEFT ； 

Header_lnsertltem(hHeadWnd, 0, Shditem) : 

이 프로그람코드는 렬에 [Heading #1] 라는 문자렬을 표시한다. 문자렬은 왼쪽맞추 
기된다. 머 리부항목의 너 비 에는 100 이 라는 적 당한 값을 설정 하고 있다. 

머 리부항목을 삽입할 때 는 머 리부조종체 에 의해 관리 되 는 색 인(여 기 에서 는 0 으로 
되 여 있 다. )을 설정 하여 야 한다는 점 을 주의해 야 한다. 

머리부조종체의 표시 

필요한 머리부항목을 모두 삽입하였다면 ShowWindowC ) 함수를 호출하여 매개 머 
리 부조종체 를 표시할수 있 다. 례 를 들어 hHeadWnd 라는 창문손잡이 의 머 리 부조종체 를 
표시 한다면 아래와 같다. 

ShowWindow(hHeadWnd, SW_SHOW) ; //머 러 부조종체 를 표시 한다 . 

머 리 부조종체 에 표시 되 는것 은 매 렬 의 제 목으로 되 는 머 리 부항목뿐이 라는데 주의 해 
야 한다. 이 시점에서는 머리부조종체밑의 자료가 표시되지 않는다. 자료들을 표시하기 
위한 처 리는 프로그람의 다른 부분에서 진행하게 된다. 그보다 앞서 머 리부조종체 가 생 
성하는 여러가지 통지문들을 파악하여야 한다. 

머리부조종제의 통지문 

머 리 부조종체 는 피 동적 인것 이 아니 라 능동적 인 조종체 이 다. 이 조종체 는 사용자에 
의해 조작되 면 통보문을 생 성한다. 례 를 들어 사용자가 머 리 부항목의 치수를 변경하면 
그것을 알려 주는 통보문이 프로그람에 전송된다. 통보문에 응답하여 적절한 처리를 진 
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행 해 야 한다. 머 리부조종체는 몇 종류의 통보문을 생성 하며 어느 통보문을 처 리 해 야 하 
는가는 프로그람의 목적에 따라 결정되게 된다. 

머리부조종체는 WM_NOTIFY 통보문을 리용하여 프로그람에 통보문을 보낸다. 
WM_NOTIFY 통보문이 보내졌을 때 wParam 에는 통보문을 생성한 조종체의 ID 가 보관 
되 여 있다. 머 리부조종체의 대부분의 통보문에서는 IParam 에 NMHEADER 구조제와 지 
시자가 보관되여 있다. NMHEADER 구조체의 정의를 아래에 보여 주었다. 


typedef struct tagNMHEADER 
{ 

NMHDR hdr ； 
int iltem ； 
int iButton ； 

HDITEM *pitem ； 

} NMHEADER ； 

hdr 는 지 금까지 몇 번 사용한적 이 있는 NMHDR 구조체 이 다. 머 리 부조종체 의 
WM_NOTIFY 통보문에서는 통보문을 생성한 머리부조종체의 손잡이가 hdr.wndFrom 
에 보관된다. hdr.idFrom 에는 머 리 부조종체의 ID 가 보관된다. hdr . code 에는 사건의 
종류를 가리 키 는 통지코드가 보관된 다. 머 리부조종체 에 서 흔히 사용되 는 통지코드들을 
표 14-2 에 보여 주었 다. 


표 14-2. 머 리 부조종체 의 주요한 통지 문들 


HDN 一 BEGINTRACK 

사용자가 렬머리부의 변경을 개시하였다. 크 
기변경을 허가하는 경우에는 령을 돌려 주고 
허가하지 않은 경우에는 령 아닌 값을 돌려 
준다. 

HDN DIVIDERDBLCLICK 

사용자가 경계선을 마우스로 두번 찰칵했 다. 

HDN—ENDTRACK 

사용자가 렬머 리부의 크기변경을 끝냈다. 

HDN ITEMCHANGED 

머리부항목이 변경되였다. 

HDNJTMCHANGING 

머리부항목이 변경되려고 하고 있다. 변경 
을 허가하는 경우에는 령을 돌려 주고 허가하 
지 않은 경우에는 령 아닌 값을 돌려 준다. 

HDN_ITEMCLICK 

사용자가 머 리부항목을 찰칵했 다. (단추형 태 
의 머리부인 경우에만) 

HDN_ITEMDBLCLICK 

사용자가 머 리부항목을 두번 찰칵했다. (단 
추형태의 머리부인 경우에만) 
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HDN—TRACK 


사용자가 렬 머 리 부의 크기 를 변경중이 다. 
크기변경을 허가하는 경우에는 령을 돌려 주 
고 허가하지 않는 경우에는 령 아닌 값을 돌 
려 준다. 


NMHEADER 구조체의 성원 item 은 조작된 머 리부항목의 색 인을 보여 주었다. 
iButton 은 눌려 진 마우스단추의 종류를 가리 킨다. 그러 나 대 부분의 응용프로그람에 서 는 
이 값을 참조하지 않는다. 

pitem 은 조작된 머 리 부항목을 가리 키는 HDITEM 구조체의 지시 자이 다. 그러 나 통 
지문으로서 HDNJTEMCLICK 혹은 HDNJTEMDBLCLICK 가 보내 졌을 때는 pitem 의 
값이 NULL 로 되 여 있 다. 


이식과 관련한 요점 : NMHEADER 구조체는 이전에 HD _ NOTIFY 구조체로 불러워왔다. 
낡은 이름의 구조체를 사용하는 번역프로그람도 있다. 

머리부조종제의 간단 한 실례프로그람 

실제로 머리부조종체를 리용하는 간단한 실례프로그람을 작성해 보자. 실례 14-1 의 
프로그람은 다섯 개 의 렬 을 가진 머 리 부조종체 를 작성 하는 프로그람이다. 이 프로그람에 서 
는 이름과 주소를 보관하는 간단한 주소록을 표시 하는데 머 리부조종체를 리용하고 있다. 

실 례 14-1. Headl 프로그람 


// 머 리부조종체의 간단한 실례 프로그람 


ttinclude < windows. h> 
tinclude <commctrl. h> 
♦include <cstring> 
♦include <cstdio> 
■elude "head, h" 


#define NUMCOLS 5 
#define DEFWIDTH 100 
#define MINWIDTH 20 
#define SPACING 8 
#define NUMENTRIES 7 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) : 
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HWND InitHeaderCHWND hParent) ； 
void InitDatabase (void); 


char szWinName[] = ” My Win”; // 창문들라스의 이름 


HINSTANCE hlnst ； 

HWND hHeadWnd ； 

int HeaderHeight ； 

int columns [NUMCOLS] = {DEFWIDTH, DEFWIDTH, 
DEFWIDTH, DEFWIDTH, 
DEFWIDTH} ； 


struct MailList { 
char name [40] : 
char street [40] ； 
char city [40] ； 
char state [3] ； 
char code [11]; 

} data[NUMENTRIES] ； 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

MSG msg ； 

WNDCLASSEX wcl; 

HACCEL hAccel ； 

HWND hwnd ； 

INITCOMMONCONTROLSEX cc ； 


// 창문클라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) : 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 
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wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ; // 큰 아이콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 

wcl.IpszMenuName = "HeaderMenu" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) : 

// 창문콜라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문콜라스가 등록되 였으므로 
창문을 작성할수 있 다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Using a Header Control", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

)； 


hlnst = hThisInst ； // 현재의 실체손잡이를 보관한다 . 

// 건반가속기를 적재 한다 . 

hAccel = LoadAccelerators(hThisInst, "HeaderMenu") : 


// 공통조종체를 초기화한다 . 
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cc.dwSize = sizeof (INITCOMMONCONTROLSEX) ; 
cc.dwICC = ICC_LISTVIEW_CLASSES ； 
InitCommonControlsEx (&cc); 


// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) ； 
UpdateWindow (hwnd); 


// 통보문순환고리를 작성 한다 . 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

if (! TranslateAccelerator (hwnd, hAccel, &msg)) { 
TranslateMessage(&msg) ； // 건반통보률 변환한다 . 
DispatchMessage (技 msg) ; // Windows 2000 에 조종을 넘 긴다 . 

} 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

int response ； 

RECT rect ； 

HDLAYOUT layout ； 

WINDOWPOS winpos ； 

■HEADER *hdnptr; 

HDITEM *hdiptr; 

PAINTSTRUCT ps ； 

TEXTMETRIC tm ； 

SIZE size ； 
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char str[80] ； 

int i, j, ColStart, chrs ； 
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int entry ； 
int linespacing ； 

HDC hdc ； 


switch (message) { 
case WM_CREATE ： 
hHeadWnd = InitHeader (hwnd) ； 

InitDatabase( ); 
break ； 

case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM.EXIT ： 

response = MessageBox(hwnd, "Quit the Program?”, 
” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O); 
break ； 

case IDM_HELP: 

MessageBox (hwnd, ” Try resizing the header.", 

” Help", MB_OK) ； 

break ； 

} 

break ； 

case WM.SIZE ： 

/* 어미창문의 크기가 변경되였을 때 
머리부항목의 크기도 변경한다 . 히 
GetClientRect (hwnd, &rect) ； 
layout, prc = 技 rect; 
layout, pwpos = &winpos ； 

Header_Layout (hHeadWnd, &layout) ； 

MoveWindow(hHeadWnd, winpos.x, winpos.y, 
winpos. cx, winpos. cy, 1); 

break ； 

case WM.NOTIFY ： 

if (LOWORD (wParam) == ID.HEADCONTROL) { 
hdnptr = (NMHEADER *) IParam ； 
hdiptr = (HDITEM *) hdnptr~>pitem ； 
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switch (hdnptr->hdr. code) { 

case HDN.ENDTRACK： // 사용자가 렬의 너비를 변경했다. 
if(hdiptr->cxy < MINWIDTH) { 
hdiptr->cxy = MINWIDTH; 
columns [hdnptr->iltem] = MINWIDTH； 

} 

else 

columns [hdnptr->iltem] = hdiptr -〉 cxy; 

InvalidateRect (hwnd, NULL, 1); 
break； 

} 

} 

break； 

case WM_PAINT： 
hdc = BeginPaint (hwnd, &ps) ； 


GetTextMetrics (hdc, &tm) ； 

linespacing = tm. tmHeight + tm. tmlnternalLeading ； 


for (entry = 0; entry < NUMENTRIES ； entry++) { 
ColStart = 0； 

for(i=0； KNUMCOLS； i++) { 


switch (i) { 

case 0： strcpyCstr, data [entry]. name) ； 
break； 

case 1: strcpy(str, data [entry]. street) ； 
break； 

case 2: strcpy(str, data [entry]. city) ； 
break； 


case 3： strcpy(str, data [entry]. state) ； 
break； 


case 4: strcpy(str, data [entry]. code) ； 
break； 


// 표시되지 않은 부분이 있는 경우는 「...」를 추가한다. 
GetTextExtentPoint32 (hdc, str, strlen(str), &size) ； 
j = 2 ； 
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while((columns [i]-SPACING) < size, cx) { 
chrs = columns [i] / tm. tmAveCharWidth； 
strcpy (&str [chrs-j], 

GetTextExtentPoint32(hdc, str, strlen(str), &size) ； 
j ++ ; 

} 

TextOut(hdc, ColStart+SPACING, 

HeaderHeight+ (entry*linespacing), 
str, strlen(str)) ； 

ColStart += columns [i] ； 

} 

} 

EndPaint(hwnd, &ps) ； 
break； 

case WM.DESTROY： // 프로그람을 끝낸다. 

PostQuitMessage (0); 
break； 
default : 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리 률 맡긴 다. */ 
return DefWindowProc(hwnd, message, wParam, lParam); 


return 0； 

} 

// 머리부조종체의 초기화 
HWND InitHeaderCHWND hParent) 
{ 

HWND hHeadWnd； 

RECT rect； 

HDLAYOUT layout； 
WINDOWPOS winpos； 

HDITEM hditem； 


GetClientRect (hParent, &rect) ； 
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// 머 리부조종체를 작성 한다. 

hHeadWnd = CreateWindow(WC_HEADER, NULL, 
WS_CHILD | WS.BORDER, 
CW.USEDEFAULT, CW.USEDEFAULT, 
0, 0, hParent, 

(HMENU) ID.HEADCONTROL, 
hlnst, NULL)； 

// 의뢰자구역의 크기에 맞는 머리부조종체의 크기률 얻는다. 
layout, pwpos = &winpos ； 
layout, prc = &rect； 

Header_Layout (hHeadWnd, ^layout) ； 


// 의뢰자구역의 크기에 맞추어 머리부조종체의 크기를 조정한다. 
MoveWindow(hHeadWnd, winpos. x, winpos.y, 
winpos.cx, winpos. cy, 0); 

HeaderHeight = winpos. cy； // 머 리부항목의 높이 률 보관한다. 
// 머 리부항목에 자료를 삽입한다. 

hditem.mask = HDI 一 FORMAT | HDI.WIDTH | HDI_TEXT； 

hditem. pszText = "Name”; 

hditem. cchTextMax = strlen(hditem. pszText) ； 

hditem. cxy = DEF WIDTH； 

hditem. fmt = HDF.STRING | HDF.LEFT； 

Headerjnsertltem (hHeadWnd, 0, &hditem) ； 

hditem. pszText = "Street" ； 

hditem. cchTextMax = strlen (hditem. pszText) ； 

Headerjnsertltem (hHeadWnd, 1, &hditem) : 


hditem. pszText = ” City”; 

hditem. cchTextMax = strlen (hditem. pszText) ； 

Headerjnsertltem (hHeadWnd, 2, &hditem) ； 

hditem. pszText = "State”; 

hditem. cchTextMax = strlen (hditem. pszText) ； 
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Header 一 InsertItem(hHeadWnd, 3, &hditem) ； 


hditem.pszText = "Postal Code"; 

hditem. cchTextMax = strlen(hditem. pszText) ； 

Header_lnsertltem (hHeadWnd, 4, &hditem) ； 

ShowWindow(hHeadWnd, SW.SHOW) ； // 머 리 부조종체 률 표시 한다 . 


return hHeadWnd ； 

} 

// 머러부조종체의 밑에 표시되는 실례자료 
void InitDatabase (void) 

{ 

strcpy(data[0]. name, ” Stan Jones”); 
strcpy(data[0].street, ”1101 Elm St. S.W."); 
strcpy(data [0]. city, "Carlsburg”) ； 
strcpy (data [0]. state, ’’MT”) ； 
strcpy (data [0]. code, "59345-0089，’); 

strcpy (data [1]. name, ” Ralph Johnson"); 
strcpy (data [1]. street, ”23978 N. Wesley Blvd.，，); 
strcpy (data [1]. city, "Laguna Hills ’’) ； 
strcpy (data [1]. state, "FL") ； 
strcpy (data [1]. code, "32465”) ； 

strcpy (data [2]. name, ’’ Chris Thomas ’’); 
strcpy (data [2]. street, ”1911 Robin Way") ； 
strcpy (data [2]. city, "St. John”); 
strcpy (data [2]. state, "MN") ； 
strcpy (data [2]. code, "55576”) ； 

strcpy (data [3]. name, ” R. W. Ridgeway") ； 
strcpy (data [3]. street, "P.O. Box 587’’); 
strcpy (data [3]. city, ’’Goldsberry’’) ； 
strcpy (data [3]. state, "MO"); 
strcpy (data [3]. code, "65345”) ； 
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strcpy(data[4]. name, "Warren Clarence"); 
strcpy(data[4].street, ”3546 Newton Lane ")； 
strcpy(data[4]. city, "Longtree"); 
strcpy (data [4]. state, " OH ” ); 
strcpy (data [4]. code, ”43556-0234") ； 

strcpy (data [5]. name, "William Spinoza ” ) ； 
strcpy (data [5]. street, ”412 Monad Ave. ”); 
strcpy (data [5]. city, "Marshall”); 
strcpy (data [5]. state, "SD”) | 
strcpy (data [5]. code, "57345”) ； 

strcpy (data [6]. name, ” W.S. Tempest") ； 
strcpy (data [6]. street, ”19 Water St. Apt 2A"); 
strcpy (data [6]. city, "Rushville") ； 
strcpy (data [6]. state, ”WI”) ； 
strcpy (data [6]. code, "53576”); 

} 

이 프로그람은 아래의 자원파일을 필요로 한다. 

// 머러부조종체의 실례 
#include < windows. h> 
ttinclude ” head, h” 

HeaderMenu MENU 

{ 

POPUP M &Options M 

{ 

MENUITEM n E&xit\tCtrl+X n , IDM.EXIT 

} 

MENUITEM M &Help M , IDM.HELP 

} 


HeaderMenu ACCELERATORS 

{ 

『 X", IDM_EXIT 

VK_F1, IDM.HELP, VIRTKEY 

} 
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머 리부파일 HEAD. H 의 내 용을 아래 에 보여 주었다. 이 머 리부파일에는 이 후에 작 
성하는 프로그람에서 사용되는 값들도 들어 있다. 

#define IDM_EXIT 100 

#define IDM_HELP 101 

#define IDM_RESET 102 

#define ID_HEADCONTROL 500 

프로그람의 실행결과를 그림 14-1 에 보여 주었 다. 



그림 14-1. 머리부조종제의 첫 실례프로그람의 실행결과 


머리부조종제의 첫 실례프로그람의 상세 

프로그람이 WM_CREATE 통보문을 받았을 때 Ini1:Header( ) 및 InitDatabase( ) 
라는 두 함수가 호출되고 있다. InitHeader( ) 는 머리부조종체의 작성과 초기화를 진행 
한다. 

함수의 파라메터로 어미창문의 손잡이를 넘긴다. 함수는 돌림값으로서 머 리부조종체 
의 손잡이를 돌려 준다. 머 리부조종체의 ID 는 ID_HEADCONTROL 로 하고 있다. 이 
ID 는 프로그람의 자원파일에 정의되여 있으며 WM_NOTIFY 통보문을 받았을 때 머리부 
조종체 를 식 별하기 위 한것 이 다. (다른 종류의 조종체 들도 WM_NOTIFY 통보문을 보내 오 
기 때문이다.) 

이 함수에서 진행되고 있는 다른 처리는 지금까지 설명해 온것들이므로 설명은 략한 
다. 이 실례프로그람에서 는 모든 렬 에 체 계 설정 으로서 100 이 라는 동일 한 크기 를 주고 
있다. 물론 프로그람의 실행시 에 사용자가 렬의 크기를 변경할수도 있다. 매 렬의 크기 
는 배렬 columns 에 보관된다. 

머 리부조종체의 높이가 HeaderHeight 라는 대 역변수에 보관되 여 있는 점 에 주의해 
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야 한다. 머 리부조종체는 어미창문의 의뢰자구역의 상단에 배 치되므로 기본창문에 정보 
를 표시 할 때 의 편위 로서 HeaderHeight 의 값이 리 용된 다. 

머 리부조종체의 작성과 초기화가 끝나면 InitDatabase( )를 사용하여 주소록의 초기 
화가 진행된다. 이 자료기지는 MailList 구조체의 배 렬 data 에 보관된다. MailList 구조 
체는 이름과 주소의 정보를 보관하는 문자렬의 배럴로 구성되여 있다. WM—PAINTH 
문을 받았을 때 배렬 data 의 내용이 표시된다. 

이 프로그람에서 처 리하고 있는 머리부조종체의 통보문은 //公 AGEA 取: T 兄 4 C 次:만이다. 
이 통보문은 사용자가(우측의 경계선을 끌기하여) 렬머리부의 크기변경을 끝냈을 때 발 
송된 다. 

렬의 너비가 변경되면 그에 맞추어 머리부조종체의 밑에 표시된 정보의 표시도 변경 
하여 야 한다. 그러 기 위 해 columns 를 새 로운 값으로 변경 하고 다시 그리 기 를 진행한다. 
사용자는 렬을 MINWIDTH 에 설정된 너비보다 작게 할수 없다는데도 주의해야 한다. 
이것은 항상 머리부가 표시되도록 보증한다. 

WM_PAINT 의 case 문에도 주목해야 할 부분이 있다. 그것은 렬에 표시되는 정보 
가 현재렬의 너비보다 긴 경우는 정보가 잘리우고 마감에 생 략기호 (...) 가 추가된다는것 
이다. 이렇게 하여 현재 표시되여 있는 정보외에도 남은 부분이 있다는것을 사용자에게 
알려 줄수 있다. 

이 프로그람에는 또 한가지 흥미 있는 점 이 있다. 抑^ 5 松표의 case 문을 보면 알수 
있지 만 창문의 크기 가 변경되 면 WM_SIZE 통보문이 발송된 다. 이 프로그람에 서는 
WM_SIZE 통보문에 대 한 응답으로서 어 미창문의 크기 에 맞추어 머 리 부조종체 의 크기 를 
조정하고 있다. 

그러나 이 처리는 반드시 필요한것은 아니다. 실제로는 머리부조종체의 크기를 고정 
시키는 응용프로그람들도 있다. 이 실례프로그람에서 는 머 리부조종체 의 크기를 어미창문 
에 맞추어 조정하는 방법을 보여 주고 있다. 


머 리부조종체 의 고급한 사용 법 


앞의 실 례 프로그람은 머 리 부조종체 를 작성하는데 필 요되 는 기 본적 인 기 술만을 보여 
주는것이 였 다. 머 리부조종체 가 가지 고 있는 다양한 기 능을 활용하면 프로그람을 보다 강 
력하고 리용하기 쉬운것으로 만들수 있다. 여기에서는 머리부조종체의 고급한 기능을 몇 
가지 사용해 보기 로 한다. 구체적으로는 앞서 본 프로그람에 아래의 기능들을 추가한다. 

• 단추형태의 머리부항목을 사용하며 마우스사건에 응답할수 있게 한다. 

• 단추형태의 머리부항목이 찰칵되였을 때 렬의 너비를 두배로 한다 

• 단추형태의 머리부항목이 두번 찰칵되였을 때 렬의 너비를 본래 크기로 복귀한다. 
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• 머리부항목의 크기가 변경되였을 때 그와 동시에 머리부항목의 밑에 표시된 
정 보를 넓 게 표시 하거 나 좁게 표시 한다. 

이 러한 기능들을 실현하기 위한 방법을 설명 하자. 

단추형태의 머리부항목의 작성 

단추형 태의 머 리부항목을 작성하는것은 아주 간단하다. 머 리부조종체를 작성할 때의 
형식 에 HDS_BUTTONS 를 포함시키는것 뿐이 다. 이 설정 을 진행 하면 매 머 리부항목이 
누름단추로 되며 마우스사건에 응답할수 있게 된다. 표준적인 머리부항목의 속성은 그대 
로 계 승된 다. 례 를 들면 경 계 선을 끌기하여 단추형 태 의 머 리 부항목의 크기 를 변경할수도 
있 다. 

마우스사건에 대한 응답 

단추형 태 의 머 리부항목이 마우스로 찰칵되 면 HDN_ITEMCUCK 통 H 아 발송된다. 
단추가 두번 찰칵되 면 HDNJTEMDBLCLICK 통히이 발송된다. 이 런 통지 문들을 받은 
프로그람은 필요에 따라 여 러 가지 처 리를 진행한다. 특별히 처 리 해 야 할것은 없다. 

HDN_TRACK 통보문 

사용자가 머 리 부항목의 크기변경 을 개 시하면 머 리 부조종체 가 HDN—BEGINTRACK 
통보문을 생 성한다. 사용자가 크기 변경 을 완료하면 머 리 부조종체 가 HDN—ENDTRACK 
통보문을 생성 한다. 크기의 변경 중에 머 리부조종체 가 HDN_TRACK 통主문을 생 성 한다. 
프로그람에 서 이 통보문들을 받으면 렬 에 표시되 여 있는 정 보의 크기 를 변경하여 야 한다. 
이 렇게 하면 사용자는 크기변경의 효과를 직 접 볼수 있다. 

머리부조종체의 확장된 실례프로그람 

실례 14-2 의 프로그람은 앞에서 작성한 머 리부조종체의 실례 프로그람에 우에서 설명 
한 확장기능들을 추가한것 이다. 

실 례 14-2. Head 2 프로그람 


// 머리부조종체의 확장된 실례 프로그람 

♦include 〈 windows. h> 
ttinclude <commctrl. h> 

♦include <cstring> 

♦include <cstdio> 

■elude "head, h" 


교육성 프로그람교육멘터 


509 




Windows 2000 프로그람작성법 


ttdefine NUMCOLS 5 
ttdefine DEFWIDTH 100 
#define MINWIDTH 20 
#define MAXWIDTH 400 
ttdefine SPACING 8 
#define NUMENTRIES 7 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
HWND InitHeaderCHWND hParent) ； 
void InitDatabase (void); 


char szWinName[] = ” My Win”; // 창문들라스의 이름 


HINSTANCE hlnst ； 

HWND hHeadWnd ； 

int HeaderHeight ； 

int columns [NUMCOLS] = {DEFWIDTH, DEFWIDTH, 
DEFWIDTH, DEFWIDTH, 
DEFWIDTH} ； 


struct MailList { 
char name [40] : 
char street [40] ； 
char city [40] ； 
char state [3] ； 
char code [11]; 

} data [NUMENTRIES] ； 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

MSG msg ； 

WNDCLASSEX wcl; 

HACCEL hAccel ； 

HWND hwnd ； 
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INITCOMMONCONTROLSEX cc ； 


// 창문물라스를 정의 한다 . 

wcl. cbSize = sizeof (WNDCLASSEX) ; 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이론 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 

wcl. IpszMenuName = "HeaderMenuEnhanced" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) : 

// 창문콜라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문콜라스가 등록되었으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"An Enhanced Header Control", // 제목 
WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CW_USEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
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NULL // 추가파라메 터 는 없 다 . 

)； 


hlnst = hThisInst ； // 현재의 실체손잡이를 보관한다 . 

// 건반가속기를 적재한다 . 

hAccel = LoadAccelerators (hThisInst, "HeaderMenuEnhanced") ； 
// 공통조종체를 초기 화한다 . 

cc.dwSize = sizeof (INITCOMMONCONTROLSEX) ; 
cc.dwICC = ICC_LISTVIEW_CLASSES; 

InitCommonControlsEx (&cc) : 


// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode); 
UpdateWindow (hwnd ); 


// 통보문순환고리를 작성 한다 . 

while(GetMessage(&msg, NULL, 0, 0)) 

{ 

if (! TranslateAccelerator (hwnd, hAccel, &msg)) { 
TranslateMessage(&msg); // 건반통보를 변환한다 . 
DispatchMessage(&msg) ; // Windows 2(X)0 에 조종을 넘 긴 다 . 

} 

} 

return msg.wParam; 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc(HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 
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int response ； 

RECT rect ； 
HDLAYOUT layout ； 
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WINDOWPOS winpos ； 
NMHEADER *hdnptr ； 
HDITEM *hdiptr, hditem ； 
PAINTSTRUCT ps ； 
TEXTMETRIC tm ； 

SIZE size ； 

char str [80] ； 

int i, j, ColStart, chrs; 

int entry ； 

int linespacing; 

HDC hdc ； 


switch (message) { 
case WM_CREATE ： 
hHeadWnd = InitHeader (hwnd) ； 

InitDatabase( ); 
break ； 

case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM.RESET ： // 체계설정의 너비로 복귀한다 . 
hditem. mask = HDI_WIDTH ； 
for(i=0 ； KNUMCOLS; i++) { 

Header_GetItem (hHeadWnd, i, &hditem); 
hditem. cxy = DEFWIDTH ； 
columns [i] = DEFWIDTH ； 

Header_SetItem (hHeadWnd, i, &hditem) ； 

} 

InvalidateRect (hwnd, NULL, 1); 
break ； 

case IDM_EXIT ： 

response = MessageBox(hwnd, ” Quit the Program?", 
” Exit”, MB—YESNO); 
if (response == ID YES) PostQuitMessage(O) ； 
break ； 

case IDM_HELP: 

MessageBox (hwnd, "Try resizing the header.", 
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” Help”, MB_OK) ； 

break ； 

} 

break ； 

case WM.SIZE ： 

/* 어미창문의 크기가 변경되였을 때 
머러부조종체의 크기도 변경한다 . */ 

GetClientRect (hwnd, &rect) : 
layout, prc = &rect ； 
layout, pwpos = 技 winpos; 

Header_Layout (hHeadWnd, &layout) ； 

MoveWindow(hHeadWnd, winpos.x, winpos. y, 
winpos.cx, winpos. cy, 1); 

break ； 

case WM.NOTIFY ： 

if (LOWORD (wParam) == ID.HEADCONTROL) { 
hdnptr = (NMHEADER *) IParam ； 
hdiptr = (HDITEM *) hdnptr->pitem ； 
switch (hdnptr - 〉 hdr. code) { 

case HDN.ENDTRACK ： // 사용자가 렬의 너비를 변경했다 . 
if(hdiptr->cxy < MINWIDTH) { 
hdiptr->cxy = MINWIDTH ； 
columns [hdnptr->iltem] = MINWIDTH ； 

} 

else 

columns [hdnptr - 〉 iltem] = hdiptr->cxy ； 

InvalidateRect (hwnd, NULL, 1); 
break ； 

case HDN.TRACK ： // 사용자가 렬의 너비를 변경하는중이다 . 
GetClientRect (hwnd, &rect); 
if(hdiptr->cxy < MINWIDTH) { 
hdiptr->cxy = MINWIDTH ； 
columns [hdnptr->iltem] = MINWIDTH ； 

} 

else 

columns [hdnptr->iltem] = hdiptr->cxy; 
rect. top = HeaderHeight ； 
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InvalidateRect (hwnd, 技 rect, 1); 
break ； 

case HDN.ITEMDBLCLICK : // 사용자가 머 리부단추를 두번 찰칵했다 . 
// 체계설정의 너비로 복귀한다 . 
hditem. mask = HDI_WIDTH ； 

Header_GetItem (hHeadWnd, hdnptr->iltem, &hditem) : 

hditem. cxy = DEFWIDTH ； 

columns [hdnptr->iltem] = DEFWIDTH ； 

Header_SetItem (hHeadWnd, hdnptr->iltem, &hditem) ； 

InvalidateRect (hwnd, NULL, 1); 

break ； 

case HDN_ITEMCLICK ： // 사용자가 머 리부단추를 찰칵했다 . 

// 단추의 너비를 두배로 한다 . 
hditem. mask = HDI_WIDTH ； 

Header_GetItem (hHeadWnd, hdnptr->iltem, &hditem) : 
hditem. cxy += hditem. cxy ； 

if (hditem. cxy > MAXWIDTH) hditem. cxy = MAXWIDTH ； 
columns [hdnptr->iltem] = hditem. cxy ； 

Header_SetItem (hHeadWnd, hdnptr->iltem, &hditem) ； 

InvalidateRect (hwnd, NULL, 1); 

break ； 

} 

} 

break ； 

case WM_PAINT: 

hdc = BeginPaint(hwnd, &ps); // 장치 상황을 얻 는다 . 


GetTextMetrics (hdc, 射 ; m) ； 

linespacing = tm. tmHeight + tm. tmlnternalLeading ； 

for (entry = 0; entry < NUMENTRIES ； entry++) { 
ColStart = 0; 

for(i=0 ； KNUMCOLS ； i++) { 
switch (i) { 

case 0: strcpy(str, data [entry]. name) ； 
break ； 

case 1 ： strcpy(str, data [entry]. street) ； 


break ； 
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case 2: strcpy(str, data [entry]. city) ； 
break ； 

case 3 ： strcpy(str, data [entry]. state) ； 
break ； 

case 4: strcpy(str, data [entry]. code) ； 
break ； 

} 

// 표시되지 않은 부분이 있는 경우는 「...」을 추가한다 . 
GetTextExtentPoint32 (hdc, str, strlen(str), &size) ； 
j = 2 ； 

while((columns [i] -SPACING) < size, cx) { 
chrs = columns [i] / tm. tmAveCharWidth ； 
strcpy(&str [chrs-j], 

GetTextExtentPoint32(hdc, str, strlen(str), &size) : 
j ++ ; 

} 

TextOut(hdc, ColStart+SPACING, 

HeaderHeight+ (entry*linespacing), 
str, strlen(str)) ； 

ColStart += columns [i] ； 

} 

} 

EndPaint(hwnd, &ps) ； // 장치 상황을 해 제 한다 . 
break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 

} 

return 0 ； 

} 
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// 머리부조종체의 초기화 
HWND InitHeaderCHWND hParent) 
{ 

HWND hHeadWnd ； 

RECT rect ； 

HDLAYOUT layout ； 
WINDOWPOS winpos ； 

HDITEM hditem ； 


GetClientRect (hParent, &rect) ； 


// 머 러부조종체를 작성 한다 . 

hHeadWnd = CreateWindow (WC.HEADER, NULL, 

WS.CHILD | WS.BORDER | HDS_BUTTONS, 
CW.USEDEFAULT, CW.USEDEFAULT, 

0, 0, hParent, 

(HMENU) ID_HEADCONTROL, 
hlnst, NULL) ； 

// 의뢰자구역의 크기에 맞는 머리부조종체의 크기를 얻는다 . 
layout, pwpos = &winpos ； 
layout, prc = &rect ； 

Header_Layout (hHeadWnd, ^layout) ； 


// 의뢰자구역의 크기에 맞추어 머리부조종체의 크기를 조정한다 . 
MoveWindow(hHeadWnd, winpos. x, winpos. y, 
winpos. cx, winpos. cy, 0); 

HeaderHeight = winpos. cy ； // 머 리부항목의 높이를 보관한다 . 
// 머 리부항목에 자료률 삽입한다 . 

hditem. mask = HDI_FORMAT | HDI_WIDTH | HDI.TEXT ； 

hditem. pszText = "Name”; 

hditem. cchTextMax = strlen(hditem. pszText) ； 

hditem. cxy = DEF WIDTH ； 

hditem. fmt = HDF_STRING | HDF_LEFT ； 

Headerjnsertltem (hHeadWnd, 0, &hditem) : 
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hditem. pszText = "Street" ； 

hditem. cchTextMax = strlen(hditem. pszText) ； 

Headerjnsertltem (hHeadWnd, 1, &hditem) ； 

hditem. pszText = "City" ； 

hditem. cchTextMax = strlen (hditem. pszText) ； 

Headerjnsertltem (hHeadWnd, 2, Shditem) : 


hditem. pszText = "State”; 

hditem. cchTextMax = strlen (hditem. pszText) ； 

Headerjnsertltem (hHeadWnd, 3, &hditem) ； 

hditem.pszText = "Postal Code"; 

hditem. cchTextMax = strlen (hditem. pszText) ； 

Headerjnsertltem (hHeadWnd, 4, &hditem) ； 

ShowWindow(hHeadWnd, SW.SHOW) ； // 머 리 부조종체 를 표시 한다 . 


return hHeadWnd ； 

} 

// 머리부조종체의 밑에 표시되는 실례자료 
void InitDatabase (void) 

{ 

strcpy(data[0]. name, "Stan Jones”); 
strcpy(data[0] .street, "1101 Elm St. S.W.") ； 
strcpy (data [0]. city, ’’Carlsburg”); 
strcpy (data [0]. state, "MT”); 
strcpy (data [0]. code, "59345-0089 ” ) ； 

strcpy (data [1]. name, "Ralph Johnson") ； 
strcpy (data [1]. street, ”23978 N. Wesley Blvd."); 
strcpy (data [1]. city, "Laguna Hills"); 
strcpy (data [1]. state, "FL") ； 
strcpy (data [1]. code, "32465”) ； 

strcpy (data [2]. name, ’’ Chris Thomas ’’); 
strcpy (data [2]. street, ”1911 Robin Way”); 
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strcpy(data[2]. city, "St. John"); 
strcpy(data [2]. state, ”MN”) ； 
strcpy(data[2]. code, ”55576”); 

strcpy(data[3]. name, M R. W. Ridgeway") ； 
strcpy(data[3]. street, ”P.O. Box 587”); 
strcpy (data [3]. city, "Goldsberry"); 
strcpy (data [3]. state, "MO") ； 
strcpy (data [3]. code, ”65345”) ； 

strcpy (data [4]. name, "Warren Clarence"); 
strcpy (data [4]. street, ”3546 Newton Lane"); 
strcpy (data [4]. city, "Longtree"); 
strcpy (data [4]. state, "OH") ； 
strcpy (data [4]. code, "43556-0234"); 

strcpy (data [5]. name, ’’William Spinoza’’); 
strcpy (data [5]. street, ”412 Monad Ave. ”); 
strcpy (data [5]. city, ” Marshall") ； 
strcpy (data [5]. state, ”SD”); 
strcpy (data [5]. code, ”57345”) ； 

strcpy (data [6]. name, "W. S. Tempest") ； 
strcpy (data [6]. street, "19 Water St. Apt 2A") ； 
strcpy (data [6]. city, "Rushville"); 
strcpy (data [6]. state, "WI") ； 
strcpy (data [6]. code, "53576 ” ) ； 

} 

이 프로그람은 앞의 프로그람에서 사용한것과 같은 HEADER . H 라는 머 리부파일을 
사용한다. 이 프로그람이 사용하는 자원파일을 아래에 보여 주었다. 

// 머러부조종체의 확장된 실례프로그람 
#include < windows. h> 

^include ” head, h” 


HeaderMenuEnhanced MENU 

{ 
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Options Help 


| Name f Street | City 

Stan JoneK ― 1101 Elm St... Carlsburg 

Ralph John... 23978 N. W... Laguna Hills 
Chris Thomas 1911 Robin ... St. John 
R. W. Ridge... P.O. Box 587 Goldsberry 
Warren Clar... 3546 Newto... Longtree 
William Spi... 412 Monad ... Marshall 
W.S. Tempest 19 Water St.... Rushville 


POPUP ，， &Options” 

{ 

MENUITEM "&Reset\tF2", IDM_RESET 
MENUITEM "E&xit\tCtrl+X", IDM_EXIT 

} 

MENUITEM "&Help", IDM_HELP 

} 

HeaderMenuEnhanced ACCELERATORS 

{ 

VK_F2, IDM_RESET, VIRTKEY 

"~X", IDM_EXIT 

VK_F1, IDM_HELP, VIRTKEY 

} 

이 프로그람의 실행결과를 그림 14-2 에 보여 주었다. 


그림 14-2. 머리부조종제의 확장판 실례프로그람의 실행결과 

머리부조종체의 확장된 실례프로그람의 상세 

이 실 례프로그람의 내 용은 머 리 부조종체 의 첫 실 례프로그람과 대 부분 갈으므로 리해 
하기 쉽다. 그러 나 일부 변경개 소에 주의 를 돌려야 한다. 

우선 HDS_BUTTONS 형 작 을 지 정 하여 머 리 부조종체 가 작성되 고 있 다. 이 에 의 해 
단추형태의 머 리부항목이 작성된다. 다음으로 WM_NOTIFY 통보문을 처 리하고 있는 
부분을 잘 살펴 보아야 한다. 대 부분의 변경 개 소는 이 부분에 있 다. 아래 에 다시한번 프 
로그람코드를 보여 주었다. 

case WM_NOTIFY ： 

520 교육성 프로그람교육웬터 



staMTFLMNMOOHSDwl 









제 14 장. 머 리부조종체와 월사업 표조종체 


if (LOWORD (wParam) == ID.HEADCONTROL) { 
hdnptr = (NMHEADER *) IParam ； 
hdiptr = (HDITEM *) hdnptr->pitem ； 
switch (hdnptr->hdr. code) { 

case HDN.ENDTRACK ： // 사용자가 렬의 너비를 변경했다 . 
if(hdiptr->cxy < MINWIDTH) { 
hdiptr->cxy = MINWIDTH; 
columns [hdnptr->iltem] = MINWIDTH ； 

} 

else 

columns [hdnptr->iltem] = hdiptr - 〉 cxy; 

InvalidateRect (hwnd, NULL, 1); 
break ； 

case HDN.TRACK ： // 사용자가 렬의 너비를 변경하는중이다 . 
GetClientRect (hwnd, &rect); 
if(hdiptr->cxy < MINWIDTH) { 
hdiptr->cxy = MINWIDTH ； 
columns [hdnptr->iltem] = MINWIDTH ； 

} 

else 

columns [hdnptr->iltem] = hdiptr->cxy ； 
rect. top = HeaderHeight ； 

InvalidateRect (hwnd, 技 rect, 1); 
break ； 

case HDNJTEMDBLCLICK : // 사용자가 머 러부단추률 두번 찰칵했다 . 
// 체계설정의 너비로 복귀한다 . 
hditem.mask = HDI.WIDTH ； 

Header_GetItem (hHeadWnd, hdnptr->iltem, &hditem) ； 

hditem.cxy = DEFWIDTH ； 

columns [hdnptr->iltem] = DEFWIDTH ； 

Header_SetItem (hHeadWnd, hdnptr->iltem, &hditem) ； 

InvalidateRect (hwnd, NULL, 1); 

break ； 

case HDNJTEMCLICK ： // 사용자가 머 리부단추률 찰칵했다 . 

// 단추의 너비를 두배로 한다 . 
hditem.mask = HDI.WIDTH ； 

Header_GetItem (hHeadWnd, hdnptr->iltem, &hditem) ； 
hditem.cxy += hditem.cxy ； 
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if(hditem.cxy > MAXWIDTH) hditem. cxy = MAXWIDTH ； 
columns [hdnptr->iltem] = hditem. cxy ； 

Header_SetItem (hHeadWnd, hdnptr->iltem, &hditem); 

InvalidateRect (hwnd, NULL, 1); 

break ； 



break ； 


매 통지문이 어떻게 처리되는가를 알아 보자. 

HDN _ ENDTRACm 문은 첫 실례프로그람과 같은 방법 으로 처 리되 고 있다. 

HDN_TRACK 통보문이 보내 졌을 때 머리부항목의 새로운 너비에 맞추어 렬에 표 
시된 정보의 너비를 조정하고 있다. 이것은 columns 배렬의 내용을 새로운 렬너비의 값 
으로 갱 신하고 다시 그리 기를 하여 실현된다. (InvalidateRect ( )를 호출한다. ) 

그러므로 사용자가 경계선을 끌기하면 머 리부항목의 밑에 표시된 정보가 동적으로 
갱신되므로 머리부항목을 넓히거나 좁힐 때의 효과를 직접 검사할수 있다. 이렇게 하면 
사용자는 매 렬에 직접 적절한 크기를 설정할수 있게 되므로 프로그람의 조작기능이 높 
아 진다. 

사용자가 단추형 태의 머 리부항목을 찰칵하면 HDN_ITEMCLICK 통보문이 발송된다. 
프로그람은 이 통보문에 대한 응답으로서 렬의 너비를 두배로 넓힌다. 머리부항목의 정 
보 를 얻 기 위 하 여 서 는 Header _ GetItem ( ) 을 사 용 하 고 정 보 를 설 정 하 려 면 
Header _ SetItem ( ) 을 사용해 야 한다는 점 에 주의 를 돌려 야 한다. 

이러한 처리가 펼요하게 되는것은 HDNJTEMCLICK 통보문이 보내 졌을 때 
NMHEADER 구조체의 pitem 성원의 값이 NULL 로 되여 있기때문이다. 다시말하여 
pitem 을 참조하는것으로는 찰칵된 머러부항목을 식별할수 없기때문이다. 

사용자가 단추형 태 의 머 리 부항목을 찰칵하면 HDNJTEMDBLCLICK H 문。' 발송 
된다. 프로그람은 이 통보문에 대한 응답으로서 머리부항목의 너비를 본래의 크기로 복 
귀 한다. 

반복해서 언급하지만 머 리부항목의 정보를 얻으러면 Header_GetItem ( ) 을 사용하 
고 정보를 설정하려면 Header_SetItem ( ) 을 사용해야 한다는 점을 명심해야 한다. 

이 프로그람에는 또 하나의 확장기능이 있다. 그것은 사용자가 [Options] 차림표에 
서 [Reset] 를 선택하면 모든 렬이 본래의 크기로 복귀되는것 이 다. 

자체로 해보기 

렬머 리 부를 동적 으로 추가하거 나 삭제 할수도 있 다. 이것은 정 보를 여 러 가지 형식으로 
표시할 때 편리하다. 례를 들면 사용자가 선택한 추가선택항목의 종류에 따라 머 리부항목 
을 적절히 추가하는것과 같은것이 가능하다. 이 기능을 실례프로그람에 추가해 보시오. 
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또 하나의 도전으로서 사용자가 머리부조종체를 비표시로 할수 있는 가능성이다. 례 
를 들어 사용자가 렬의 너비를 조정하도록 하기 위해 머리부조종체를 리용하고 그것이 
끝나면 머 리부조종체를 비표시 로 한다. 이 렇게 하면 화면에 보다 많은 정보를 표시할수 
있게 된다. 


월사업표조종체 


매우 편리한 조종체의 하나로서 월사업표조종체 A 있다. 월사업표조종체는 1 개월이 
상의 달력을 표시하고 날자를 선택할수 있게 한다. 체계설정으로는 현재의 날자가 선택 
된 상태로 월사업표조종체가 표시된다. 

사용자는 달력의 월이나 년을 변경할수 있다. 또한 여러가지 튀여나오기차림표, 오 
르내리기조종체 및 화살단추가 장비되여 있으므로 사용자는 월사업표조종체를 손 쉽게 
조작할수 있다. 월사업표조종체는 매우 우수하게 설계되여 있으므로 여러가지 형식으로 
표시할수도 있지만 보통은 체계설정의 형식으로도 충분하다. 

월사업표조종체는 날자입력을 필요로 하는 응용프로그람에 우수한 시각적효과를 제 
공할수 있다. 

월사업표조종체의 작성 

월사업 표조종체 를 작성 하려 면 창문클라스에 MONTHCAL—CLASS 를 지 정 하고 
CreateWindowC ) 또는 CreateWindowEx () 를 호출한다. WS_CHILD 형 식도 지정 한다. 
的고형식과 的쬬_5幻穴 CS ? 형식도 포함시키는것 이 일반적 이 다. 월사업표조종체는 
초기의 크기를 령 으로서 작성 한다. 왜 냐하면 프로그람을 실행할 때까지는 조종체의 크기 
를 결정할수 없기때문이다. (례하면 서체의 종류에 맞추어 크기를 결정한다.) 

월사업표조종체를 작성할 때는 형식 에 여 러가지 추가선택 항목을 설정할수 있다. 이 
장의 실례프로그람에서 는 사용되 지 않지 만 참고할수 있게 표 14-3 에 월사업 표조종체 의 
형식의 추가선택항목을 보여 주고 있다. 


표 14-3. 월사업표조종체의 형식의 추가선택항목 


MCS—DAYSTATE 

달력 이 표식 이 불는 특정한 날 (휴식 일 등)의 
정보를 요구하게 된다. 

MCS MULTISELECT 

날자의 범위를 선택할수 있게 된다. 

MCS NOTODAY 

현재의 날자가 지적되지 않게 된다. 

MCS NOTODAYCIRCLE 

현재의 날자가 동그라미 로 표시되지 않게 된다. 

MCS WEEKNUMBERS 

주의 번호가 표시되게 된다. 
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월사업표조종체에 롬보문들 보내기 

월사업 표조종체는 여 러 가지 통보문에 응답한다. 흔히 사용되는 통보문들을 표 14-4 
에 보여 주었다. 월사업표조종체 에 통보문을 보내 려면 통보문을 보내는 측으로 조종체의 
손잡이를 설정하고 SendMessage ( )를 호출한다. 그러나 통보문을 보내는 마크로를 사 
용하는것이 보다 간단하다. 표 14~4 에 제시한 통보문들에 대응하는 마크로들을 아래에 
보여 주었다. 


BOOL MonthCal_GetCurSel (HWND hCal, SYSEMTIME *st )； 
BOOL MonthCal_GetMaxToday Width (HWND hCal); 

BOOL MonthCal_GetMinRequest (HWND hCal, RECT *rect); 
BOOL MonthCal_GetToday (HWND hCal, SYSEMTIME *st) ； 
BOOL Mon 仕 iCal_SetCurSel(HWND hCal, SYSEMTIME *st) ； 
VOID MonthCal_SetToday (HWND hCal, SYSEMTIME *st); 


표 14-4. 월사업표조종체의 주요한 통보문 




MCM_GETCURSEL 

현재 선택되 여 있는 날자를 얻 는다. 호출 
이 성공하면 령 아닌 값이 돌려 지 고 실패하 
면 령 이 돌려 진다. wParam 에는 령을 설정 
한다. IParam 에는 현재 선택 되 여 있는 날자 
를 보관하기 위 한 SYSTEMTIME 구조체 의 
지시 자를 설정한다. 

MCM_GETMAXTODAYWIDTH 

[Today] 로 표시된 부분의 문자렬의 너비 
를 돌려 준다. wParam 과 IParam 에 는 령 을 
설정 한다. 

MCM.GETMINREQRECT 

달력 을 표시할수 있는 창문의 최 소크기 를 
얻는다. 호출이 성공하면 령 아닌 값이 돌려 
지 고 실패 하면 령 이 돌려 진다. wParam 에 는 
령 을 설정 한다. IParam 에 는 크기 를 보관하기 
위 한 RECT 구조체 의 지 시 자를 설 정 한다. 

MCM-GETTODAY 

현재의 날자를 얻는다. 호출이 성공하면 령 
아닌 값이 돌려 지고 실패하면 령이 돌려 진 
다. wParam 에 는 령 을 설정 한다. IParam 에 는 
현재의 날 자를 보관하기 위 한 
SYSTEMTIME 구조체 의 지 시 자를 설 정 한다. 

MCM_SETCURSEL 

날자를 선택한다. 호출이 성공하면 령 아닌 
값이 돌려 지 고 실패하면 령 이 돌려 진다. 
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wParam 에는 령을 설정한다. IParam 에는 선 
택 하는 날 자를 보관하기 위 한 
SYSTEMTIME 구조체 의 지 시 자를 설정 한다. 

MCM_SETTODAY 

현재 의 날자를 설 정한다. 돌림 값은 돌려 지 
지 않는다. wParam 에 는 령 을 설정한다. 
IParam 에 는 현재 의 날자를 보관하기 위한 
SYSTEMTIME 구조체 의 지 시 자를 설 정 한다. 


날자를 설정 하거 나 엄 으려 고 할 때 는 날자를 SYSTEMTIME 구조체 에 설정 한다. 
SKSTSAfr/Affi： 구조체의 정의를 아래에 보여 주었다. 


typedef struct _SYSTEMTIME { 


WORD 

wYear； 

// 

년 

WORD 

wMonth； 

// 

월 (1~12) 

WORD 

wDayOfWeek； 

// 

요일 (0~6) 

WORD 

wDay； 

// 

일 效， ■ 

WORD 

wHour； 

// 

시 

WORD 

wMinute； 

// 

분 

WORD 

wSecond； 

// 

초 

WORD 

wMilliseconds ； 

// 

미리초 


} SYSTEMTIME； 


SYSTEMTIME 구조체 에 는 날자와 시 간의 두개 의 성 원이 들어 있다. 월사업 표조종 
체에는 시간에 관한 정보가 제공되여 있지 않지만 내부적으로는 관리되고 있다. 실례로 
조종체 를 작성하면 현재 의 시 간정 보가 현재 의 날자정 보에 내 부적 으로 추가된 다. 

월사업표조종체의 ■지문 

월사업표조종체 는 기 본적 으로는 피 동적 인 조종체 이 나 WM_NOTIFY 통보문과 함께 
아래 에 보여 준 통지 문들을 생성할수도 있다. 


MCN—GETDAYSTATE 

날자의 표시방법을 알아 보기 위해 발송된다. 실 
례로 휴식일을 굵은체로 표시하는것 등 

MCN SELCHANGE 

날자의 선택이 변경되였다. 

MCN SELECT 

사용자가 날자를 선택하였다. 


월사업 표의 실 례프로그람에 서 는 우와 같은 통보문들을 사용하지 않는다. 
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월사업표조종체의 크기를 설정하기 

이 미 설명 한것처 럼 월사업 표조종체 를 작성 하는 시 점 에서는 그의 크기를 령으로 하고 
후에 크기를 설정하는것 이 일반적 이 다. 

달력 을 표시 할수 있는 최 소의 크기 를 엄 으려 면 월사업 표조종체 에 MCM _ 
GETMINREQRECTH 문을 보낸다. 돌림 값으로서 RECT 구조체 에 달력 을 표시 할수 있 
는 최소의 크기가 돌려 진다. 

계속하여 [ Today ] 로 표시된 부분의 문자렬의 너비를 엄어야 한다. 이 문자렬은 현 
재의 날자를 표시한다. 월사업표조종체의 너 비는 [ Today ] 로 표시된 부분의 문자렬의 
너 비 와 MCM_GETMINREQRECT 통보문에 서 얻 은 너 비 가운데 서 큰것 으로 하여 야 한 
다. (보통 [ Today ] 로 표시된 부분의 문자렬의 너비가 작게 되지만 프로그람의 이식성을 
고려한다면 두 너비값을 비교하여 야 한다.) 

적절한 크기가 결정되면 앞에서 설명한 MoveWindow () 등의 함수를 사용하여 월사 
업표조종체의 크기를 설정한다. 뒤에서 작성하는 실례프로그람에서 이 처 리를 진행하는 
부분을 아래에 보여 주었다. 

hCal = CreateWindow(MONTHCAL_CLASS, 

"Month Calendar", // 사용되지 않는다 . 

WS_BORDER | WS_VISIBLE | WS_CHILD, 

0 , 0 , 0 , 0 , 

hdwnd, NULL, hlnst, NULL); 

// 달력의 크기를 확인한다 . 

MonthCal_GetMinReqRect(hCal, &rect); // 최소의 크기를 엄는다 . 

// [Today ] 라고 표시된 부분의 문자렬의 너비를 확인한다 . 
today width = MonthCal_GetMaxToday Width (hCal) : 
if (todaywidth > rect. right) rect. right = todaywidth ； 

// 마지막으로 조종체의 크기를 설정한다 . 

MoveWindow(hCal, 0, 0, rect. right, rect. bottom, 1); 

이러한 순서로 처러하면 조종체의 크기는 달력과 그것에 대응한 차림표나 조종체를 
표시하는데 충분하게 된 다. 

월사업표조종체의 실례프로그람 

실례 14-3 의 프로그람은 월사업표조종체의 사용실례를 보여 주었다. 기 본차림 표를 
선택하여 달력 을 능동으로 하거 나 현재 선택 되 여 있는 날자를 표시 할수 있 다. 
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달력은 대 화칸안에 표시된다. 대 화칸에 는 달력외 에도 [Show Date ], [ OK ] 및 
[ Cancel ] 의 세개 단추가 있다. [Show Date ] 단추를 누르면 현재 선택되여 있는 날자가 
통보칸에 표시 된 다. [ OK ] 단추를 누르면 현재 선택 되 여 있는 날자가 대 역 변수 st 에 보관 
된다. [ Cancel ] 단추를 누르면 안 의 값이 변경되지 않는다. 야 의 값은 현재 선택되여 있 
는 날자를 기본차림표에서 표시하는데 리용된다. 

실 례 14-3. Cal 프로그람 


// 월사업표조종체의 실례 


^include < windows. h> 
itinclude <commctrl.h> 
ttinclude <cstdio> 
include ” cal.h” 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
BOOL CALLBACK DialogFunc(HWND, UINT, WPARAM, LPARAM) ； 

char szWinNameG = "MyWin”; // 창문클라스의 이름 

HINSTANCE hlnst； 

HWND hCal； 

SYSTEMTIME st； 
int dateset = 0； 


int WINAPI WinMain (HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

MSG msg； 

HWND hwnd； 

WNDCLASSEX wcl； 

HACCEL hAccel； 

INITCOMMONCONTROLSEX cc； 


// 창문들라스를 정의 한다. 
wcl.cbSize = sizeof (WNDCLASSEX) ； 

wcl.hlnstance = hThisInst； // 실체의 손잡이 
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wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ; // 큰 아이 른 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 

wcl. IpszMenuName = "MonthCalMenu" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) : 

// 창문콜라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문클라스가 등록되었으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Using a Month Calendar", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

)； 


hlnst = hThisInst ； // 현재의 실체손잡이를 보관한다 . 
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hAccel = LoadAccelerators (hThisInst, ” MonthCalMenu”) ; 


// 공통조종체 를 초기 화한다 . 

cc.dwSize = sizeof (INITCOMMONCONTROLSEX) ; 
cc.dwICC = ICC_DATE_CLASSES; 
InitCommonControlsEx (&cc); 


// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) ； 
UpdateWindow (hwnd); 


// 통보문순환고리를 작성 한다 . 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

if(! TranslateAccelerator (hwnd, hAccel, &msg)) { 
TranslateMessage(&msg) ； // 건반통보률 변환한다 . 
DispatchMessage (技 msg) ; // Windows 2000 에 조종을 넘 긴다 . 

} 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

int response ； 
char str[255] ； 


switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 


case IDM_DIALOG: 

DialogBox(hInst, "MonthCalDB", hwnd, (DLGPROC) DialogFunc) ； 
break ； 
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case IDM.GETDATE ： 
if (dateset) { 
sprintf(str, ，， %d/%d/%d”, 

st. wMonth, st. wDay, st. wYear) ； 

MessageBox(hwnd, str, ’’Date Selected”, MB_OK) ； 

} else 

MessageBox(hwnd, ” Date not set”, "Error", MB_OK); 
break ； 

case IDM_EXIT: 

response = MessageBox (hwnd, "Quit the Program? M , 

” Exit”, MB.YESNO) ； 
if (response == ID YES) PostQuitMessage(O) : 
break ； 

case IDM_HELP: 

MessageBox(hwnd, ” Try the calendar. ”, ” Help”, MB_OK) ； 
break ； 

} 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 


return 0 ； 

} 

// 대화함수 

BOOL CALLBACK DialogFunc (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

static HWND hCal ； 

RECT rect ； 
int today width ； 
char str [255] ； 
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SYSTEMTIME tempst ； 


switch (message) { 
case WMJNITDIALOG： 
hCal = CreateWindow (MONTHCAL.CLASS, 

"Month Calendar", // 사용되지 않는다 . 
WS_BORDER | WS.VISIBLE | WS.CHILD, 

0, 0, 0, 0, 

hdwnd, NULL, hlnst, NULL); 

// 달력의 크기를 설정한다 . 

MonthCal_GetMinReqRect(hCal, &rect) ； // 최소크기를 얻 는다 . 
today width = MonthCal_GetMaxToday Width (hCal) ； 
if (todaywidth > rect. right) rect. right = todaywidth ； 

Mo ve Window (hCal, 0, 0, rect. right, rect. bottom, 1); 
return 1 ； 

case WM.COMMAND： 
switch (LOWORD (wParam)) { 
case ID_GETDATE： 

MonthCal_GetCurSel (hCal, &tempst) ； 
sprintf(str, ”%d/%d/%d”, tempst. wMonth, 
tempst. wDay, tempst. wYear) ； 

MessageBox(hdwnd, str, "Date Selected", MB_OK) ； 
return 1; 
case IDOK: 

MonthCal_GetCurSel (hCal, &st) ； 
dateset = 1； 
case IDCANCEL： 

EndDialog (hdwnd, 0); 
return 1 ； 



return 0 ； 

} 

이 프로그람은 아래의 자원파일을 펼요로 한다. 
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#include < windows. h> 
^include "cal.h” 


MonthCalMenu MENU 

{ 

POPUP ” ^Calendar” { 

MENUITEM "&Calendar\tF2 n , IDM.DIALOG 
MENUITEM ”&Get Selected Date\tF3”, IDM.GETDATE 
MENUITEM ”E&xit\tC 切 : 1+X", IDM_EXIT 

} 

MENUITEM ” &Help”, IDM.HELP 


MonthCalMenu ACCELERATORS 

{ 

VK_F2, IDM.DIALOG, VIRTKEY 
VK_F3, IDM_GETDATE, VIRTKEY 
， … X", IDM.EXIT 
VK_F1, IDM.HELP, VIRTKEY 

} 

MonthCalDB DIALOGEX 18, 18, 150, 78 
CAPTION "Demonstrate a Month Calendar" 

STYLE DS_MODALFRAME | WS.POPUP | WS.CAPTION | WS.SYSMENU 

{ 

DEFPUSHBUTTON ”OK", IDOK, 100, 10, 38, 16 
PUSHBUTTON "Show Date", ID.GETDATE, 100, 30, 38, 16 
PUSHBUTTON "Cancel", IDCANCEL, 100, 50, 38, 16 

} 

머 리 부과일 CAL.H 의 내 용을 아래 에 보여 주었 다. 


#define IDM.DIALOG 100 

ttdefine IDM.GETDATE 101 

ttdefine IDM.EXIT 102 

#define IDM.HELP 103 
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프로그람의 실 행 결파를 그럼 14-3 에 보여 주었 다. 


그림 14-3. 월사업표조종제의 실레空■그람의 실행1과 


공들조종체를 마치며 


이 장까지 의 다섯개 장에 서 는 가장 많 이 사용되 는 몇 가지 공통조종제들에 대 해 설 
명하였 다. 이 조종체 들의 사용방법 을 파악하면 다른 조종체 들의 사용방법 도 자체 로 쉽 게 
배울수 있다. 공통조종체전반에 공통되는 사용방법을 개괄하면 다음과 같다. 

• 작성 및 초기화 

• 조종체에 통보문을 보낸다. 

• 조종체 가 생성한 통보문을 처 리한다. 


제 10 장을 시 작할 때 설명한것처 럼 공통조종체들을 사용하면 응용프로그람이 볼 품 
이 있는 최신의 세련된 양상으로 된다. 
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제 15 장 


스레드에 기초한 다중과제처리 


이 장에 서 는 Windows 2000 이 제 공하는 스레 드 ( Thread ) 에 기 초한 다중과제 
처 리 기 능에 대 해 설 명 한다. 이 책 의 서 두에 서 언 급한것 처 럼 Windows 2000 은 
두가지 형 식의 다증과제차타를 지원하고 있다. 첫번째 형 식은 프로세스에 기초한 
것으로서 초기 판본의 Windows 에서부터 지원되고 있는 다중처리형식이다. M 
로세스탄 간단히 말하면 실 행 중의 프로그람이다. 프로세 스에 기 초한 다중과제 처 
리 에서 는 두개 이상의 프로세스를 동시 에 실행할수 있다. 

다중과제처리의 두번째 형식은 스레드에 기초하고 있다. 스레드란 프로세스내 
에서 실행되는 프로그람의 흐름이다. Windows 2000 에서는 하나의 프로세스가 적 
어도 하나의 스레드를 가지며 두개 이상의 스레 드를 가져도 무방하다. 스레 드에 기 
초한 다중과제 처 리 에서는 한 프로그람에 속하는 두개 이상의 부분을 동시 에 실행할 
수 있 다. 이 기 능을 활용하면 매 우 효과적 인 프로그람을 작성할수 있 다. 왜 냐하면 
프로그람작성 자들이 독립 적 으로 실행되는 스레 드들을 자유롭게 작성할수 있으며 프 
로그람의 실행을 관리할수 있기때문이다. 

스레 드에 기 초한 다중과제처 리 방식 을 사용함으로써 동; 7 /호/라고 하는 특수한 
기능도 필요하게 된다. 동기화는 스레 드 ( 또는 프로세스)의 동시실행 을 적 절히 
관리 하기 위 한 특수한 수법 이 다. Windows 2000 은 동기 화를 지 원하기 위 한 완전 
한 부분체계를 제공한다. 이 장에서는 그가운데서 관건적 인 기능만을 설명한다. 

16 bit 의 Windows 3. 1 에 서 는 스레 드에 기 초한 다중과제 처 리 를 지 원 하지 
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다중스레드프로그람의 작성 


만일 다증스레드프로그람을 작성해 본 경험이 없다면 이 장을 읽은 후에 놀라움을 
느끼 게 될 것 이 다. 스레드가 초의 다중과제 처 리 에 서 는 프로그람의 실 행 을 부분에 까지 완전 
히 조종할수 있는 새로운 기능을 여러분의 프로그람에 추가하여 준다. 이 기능에 의해 
보다 효과적 인 프로그람을 작성할수 있게 된다. 

실례로 첫번째 스레드에서 파일을 분류하고 두번째 스레드에서는 기억기자원에서 정 
보를 엄 고 세 번째 스례 드에 서 사용자입 력 을 처 리 하는것 을 실현 할수 있 기 때 문이 다. 스레 
드기초의 다중과제처리에 의해 CPU 시간을 거의 랑비함이 없이 개개의 스레드를 동시에 
실 행할수 있 다. 

하나의 프로세스가 적어도 하나의 스레드를 가지고 있다는것은 중요하다. 설명상 필 
요에 의해 이것을 기본스레드 (main thread ) 라고 부르기로 한다. 기본스레드란 프로그람 
의 기 동시 에 작성 되 는 스레 드이 다. 기 본스레 드안에 서 다른 스레 드를 한개 이 상 작성할수 
있 다. 

보통은 새로운 스레드가 작성되면 그것이 곧 실행을 개시한다. 그러므로 프로세스는 
하나의 스레 드를 실행 하는것으로 개시되 여 한개 이상의 스레 드를 추가하는것 으로 된다. 


스레드의 작성 

스레 드를 작성 하자면 CreateThread ( ) 타는 API 함수를 사용한다. 선언은 다음과 같 


HANDLE CreateThread ( LPSECURITY_ATTRIBUTES IpSecAttr , 
DWORD dwStackSize , 

LPTHREAD _ START_ROUTINE lpThreadFunc , 
LPVOID IpParam , 

DWORD dwFlags , 

LPDWORD lpdwThreadID ) : 


IpSecAttr 는 스레 드에 주는 보안속성 에 대 한 지 시 자이 다. IpSecAttr 에 NULL 을 설 
정하면 체계설정의 보안서술자가 사용된다. 


참 II : Windows 2000의 보 안기능에 대해서는 제20장에서 설명한다. 이 장에서는 체계 
설정의 보안서술자만을 사용한다. 
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매개 스레드는 각각 전용의 탄창 ( Stack ) 을 가전다. dwStadkSize 파라메 터 에는 새로 
운 스레 드의 탄창크기 를 byte 단위 로 설정 할수 있 다. 이 파라메터 의 값에 령 을 설정 하면 
스레드를 작성한 스레드와 같은 크기의 탄창이 주어 진다. 이 경우에도 후에 필요에 따 
라 탄창의 크기 를 확대 할수 있 다. (wStadkSize 에 는 령 을 설정 하는것 이 일 반적 이 다. ) 
스레드의 실행은 스레드를 작성한 프로세스에서 스레드함수라五 부르는 함수를 기동 
하는것으로서 개시된다. 스레드의 실행은 스레드함수가 완료할 때까지 계속된다. 이 함 
수의 주소 즉 스레 드의 입 구점 (Entry point ) 을 lpThreadFunc 에 설 정 한다. 모든 스레 
드함수들은 다음과 같이 선언되여야 한다. 


DWORD WIN API threadfunc(LPVOID param ) : 


새 로운 스레 드에 주려 는 파라메 터 를 CreateThread () 의 IpParam 에 준다. 이 32 bit 
의 값이 스레 드함수의 파라메터 로 된다. 이 파라메터는 임의의 목적으로 사용된다. 스레 
드함수는 완료되 였을 때의 상태를 돌림값으로 넘겨 준다. 

dwFlag 파라메터는 스레 드의 실행상태 를 결정 하는 성원이 다. 이 파라메터 에 령 이 
설정된 경우는 곧 스레드의 실행 이 개시된다. CREATE_SUSPEND 4 설정된 경우는 스 
레 드가 정 지 상태 로 작성 되 여 실 행 개 시 를 대 기 한다. (뒤 에 서 설 명 하는 ResumeThreadC ) 
를 사용하면 실행을 개시시킬수 있다.) 

스레 드를 식 별하기 위 한 ID 가 두배 단어 형의 지 시 자로서 lpdwThreadID 에 돌려 진다. 

이 함수는 호출이 성 공하면 스레 드의 손잡이 를 돌려 주고 실패하면 NULL 을 돌려 
준다. 스레 드의 손잡이 는 CloseHandleC ) 을 사용하여 파괴 할수 있지 만 그렇 게 하지 않아 
도 어미프로세스가 완료할 때 자동적으로 파괴된다. 

스레드의 끝내기 

이미 설명한것처럼 스레드의 실행은 입구점으로 되여 있는 스레드함수가 완료하는것 
으로서 끝난다. 그러 나 TerminateThread ( ) 또는 ExitThreadC 乂의 어 느 함수를 사용하 
면 프로세스로부터 임의의 시점에서 완료시킬수도 있다. 선언은 다음과 같다. 


BOOL TermlnateThread (HANDLE hThread , DWORD dwStatus ) : 
VOID ExitThread(DWORD dwStatus ); 


TerminateThreadC ) 에서는 완료시키 려는 스레 드의 손잡이를 hThread 에 설정한다. 
아래 의 ExitThread ( ) 는 스레드가 자기 자신을 도중완료할 때 사용한다. 어 느 함수도 
dwStatus 에 완료코드를 설정한다. 호출이 성공하면 TerminateThread ( ) 는 령 이 아닌 
값을 돌려 주며 실패하면 령을 돌려 준다. 

ExitThreadC ) 를 호출하는것 은 스레 드함수를 정 상완료시 키 는것 과 기 능적 으로 동등 
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한것이다. 이것은 탄창이 적절하게 재설정된다는것이다. 

TerminateThread ( )를 사용하여 스레드를 완료시킨 경우는 스레드가 곧 정지되고 
탄창 등의 소거 ( Cleanup ) 처리가 진행되지 않는다. TerminateThread ( ) 를 사용하면 중 
요한 처리를 진행하고 있는 스레드를 정지시켜 버리는 일도 있다. 이러한 리유로부터 스 
레드함수가 정상완료할 때까지 스레드를 강제완료시키지 않는것이 최량이며 가장 간단한 
방법으로 된다. 이 장의 실례프로그람이 대체로 이 방법을 사용한다. 

다중스레드의 실 례프로그람 

실례 15-1 에 제시한 프로그람은 [Demonstrate Thread ] 차림표를 선택하면 두개의 
스례드를 작성하는 프로그람이 다. 매개 스레드는 for 순환을 사용하여 5000 회 순환하면 
서 처 리를 진행하며 그의 순환회수를 표시한다. 프로그람을 실행하면 두개의 스레드가 
동시에 실행되는 상황을 알수 있다. 

실례 15-1. Thread 프로그람 


// 간단한 다중스례드프로그람 


ttinclude 〈 windows. h> 
^include <cstring> 
ttinclude <cstdio> 
^include "thread, h” 


Mefine MAX 5000 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
DWORD WINAPI MyThreadKLPVOID param) ； 

DWORD WINAPI MyThread2 (LPVOID param) ； 


char szWinNameG = M MyWin”; // 창문클라스의 이름 
char str[255]; // 표시할 문자렬을 보관한다 . 

DWORD Tidl, Tid2 ； // 스레드 ID 


int WINAPI WinMain (HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 
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MSG msg ； 

WNDCLASSEX wcl ； 
HACCEL hAccel ； 


// 창문콜라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ; 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. li 犯 zClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계 설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이론 
wcl. hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl. IpszMenuName = "ThreadMenu" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 


// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


A 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow( 
szWinName, // 창문믈라스의 이름 
"Demonstrate Threads", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자리 표는 Windows 가 결 정 하게 한다 . 
CWJJSEDEFAULT, // Y 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 높이 는 Windows 가 결 정 하게 한다 . 
NULL, // 어미창문은 없다 . 
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NULL, // 믈라스차림 표의 덧쓰기는 하지 않는다 . 

hThisInst, // 실체의 손잡이 

NULL // 추가파라메 터 는 없 다 . 

)； 


// 건반가속기 를 적 재한다 . 

hAccel = LoadAccelerators(hThisInst, "ThreadMenu") : 

// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while(GetMessage(&msg , NULL, 0, 0)) 

{ 

if(! TranslateAccelerator(hwnd, hAccel, 技 msg)) { 
TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage(Smsg) ; // Windows 2000 에 조종을 넘 긴다 . 

} 

} 

return msg. wParam ； 

} 


/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

int response ； 


switch (message) { 


case WM_COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM_THREAD ： // 스레 드를 작성 한다 . 
CreateThread (NULL, 0, 


(LPTHREAD_START_ROUTINE) MyThreadl, 
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(LPVOID) hwnd, 0, &Tidl) ； 

CreateThread(NULL, 0, 

(LPTHREAD_START_ROUTINE) MyThread2, 
(LPVOID) hwnd, 0, 技 Tid2); 

break ； 

case IDM.EXIT ： 

response = MessageBox(hwnd, "Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O) ； 
break ； 

case IDM_HELP: 

MessageBox (hwnd, 

” FI: Help\nF2: Demonstrate Threads”, 

” Help", MB_OK) ； 

break ； 

} 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam); 

} 

return 0 ； 

} 

// 프로세스안에서 실행되는 스레드 

DWORD WINAPI MyThreadl (LPVOID param) 

{ 

int i ； 

HDC hdc ； 

for(i=0 ； i<MAX ； i++) { 
sprintf(str, ” Thread 1 ： loop # %5d ", i); 
hdc = GetDCC(HWND) param); 

TextOut(hdc, 1, 1, str, strlen(str)) ; 
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ReleaseDC ((HWND) par am, hdc); 

} 

return 0 ； 

} 

// 프로세스안에서 실행되는 또 하나의 스레드 
DWORD WINAPI MyThread2(LPVOID param) 
{ 

int i; 

HDC hdc ； 


for(i=0 ； i<MAX ； i++) { 
sprintfCstr, "Thread 2 ： loop # 祝 d ", i) ； 
hdc = GetDC((HWND) param); 
TextOut(hdc, 1, 20, str, strlen(str)) ； 
ReleaseDC((HWND) param, hdc); 

} 

return 0 ； 

} 


이 프로그람에서 리용하는 자원파일 THREAD . 묘의 내용은 다음과 같다. 


#define IDM_THREAD 100 

#define IDM_HELP 101 

#define IDM_EXIT 102 


이 프로그람은 아래의 자원파일도 필요로 한다. 


ttinclude 〈 windows, h 〉 
■elude "thread, h" 


ThreadMenu MENU 

{ 

POPUP "SThreads" { 

MENUITEM "Demonstrate &Threads \ tF2", IDM_THREAD 
MENUITEM "E&xit\tCtrl+X", IDM_EXIT 

} 

MENUITEM "&Help", IDM_HELP 
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ThreadMenu ACCELERATORS 

{ 

VK_F1, IDM.HELP, VIRTKEY 
VK_F2, IDM_THREAD, VIRTKEY 
『 X", IDM_EXIT 

} 


i ■技! . u ■사 市 ra 
Ihreads Help 
Thread 1 ： loop ff 4999 
Thread 2 ： loop # 4999 


그림 15-1. 다중스레드프로그람의 실행 결과 

다중스레드프로그람의 상세 

[Demonstrate Threads ] 차림표가 선택되면 다음의 프로그람코드가 실행된다. 

case IDM_THREAD: // 스레 드를 작성 한다 . 

CreateThread(NULL, 0, 

(LPTHREAD_START_ROUTINE) MyThreadl , 

(LPVOID) hwnd, 0, &Tidl) : 

CreateThread(NULL, 0, 

(LPTHREAD_START_ROUTINE)MyThread2, 

(LPVOID) hwnd, 0, &Tid2) : 

break ； 

CreateThreadC ) 의 첫 호 출은 MyThreadl ( ) 을 기 동 하며 두 번 째 호 출은 
MyThread 2( )를 기동한다. 매 스레 드함수에 는 파라메 터 로서 기 본창문의 창문손잡이 
( hwnd ) 가 전달되 고 있는 점 에 주의 해 야 한다. 매 개 스례 드는 이 파라메터 로부터 장치 
상황의 손잡이를 얻고 기본창문에 정보를 표시한다. 

실행 이 개시되 면 매 개 스레드(기 본스레 드를 포함)가 독립 적 으로 동작한다. 례하면 
스례드의 실행도중에 도움말통보칸을 표시할수도 있고 프로그람을 완료할수도 있으며 다 
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른 스레드를 기동할수도 있다. 프로그람을 완료하면 모든 새끼스레드도 자동적 으로 완료 
한다. 

앞으로 더 나가기에 앞서 이 프로그람을 사용하여 여러가지 실험을 해보는것이 유익 
하다. 실례로 현재는 스레드 함수가 완료 하는 것으로서 스레 드가 완료 하지만 
ExitThread ( )를 사용하여 스레드를 도중완료시키는것도 시험해 볼수 있다. 매개 스레 
드의 여러개의 실체 ( Instance ) 를 기동하는것도 시험해 볼수 있다. 


CreateThreadf 》와 ExitThreadt 》의 대용함수 


C / C ++ 번 역 프로 그 람 이 나 C / C ++ 의 표준서 고의 종류 에 따 라 CreateThread ( ) 와 
ExitThreadC ) 를 사용하지 않는 편이 좋은 경우가 있다. 그것은 이 두 함수가 약간한 기 
억기잃기를 발생하는 경우가 있기때문이다. 

기억기잃기 (Memoxy leak ) 란 기억기를 잃어 버리는것을 말한다. 이것은 프로그람에 
의 해 확보된 기 억 기의 일부가 해제되지 않는것 이 원인으로 되 여 발생한다. 

Microsoft Visual C ++ 를 포함한 많은 번역프로그람들에서는 어 느 C 八>+표준서 고를 
리 용한 다중스레 드프로그람에서 CreateThread () 나 ExitThread () 를 사용한 경우에 기 
억 기 잃기 가 발생 하는 때 가 있 다. (만일 프로그람에 서 C 八>+의 표준서 고를 리 용하지 않는 
다면 이 러한 문제는 발생하지 않는다.) 이 문제를 해결하기 위해 스레드의 개시와 완료 
에 는 Win 32 API 가 아니 라 C 八>+의 표준서 고함수를 사용하도록 한다. 

여기서는 Microsoft 가 독자적으로 제공하는 스레드를 작성하는 함수와 완료하는 함 
수를 소개한다. 만일 다른 번역프로그람을 사용하고 있다면 펼요에 따라 사용자지도서를 
참고하여 CreateThread ( 고와 ExitThread ( )를 사용하여 도 문제 점 이 없는가를 확인하여 
야 한다. 


Microsoft 의 독자적인 스레드작성함수와 완료함수 

Microsoft Visual C ++ 에 있어서 CreatThread ( ;와 ExitThread ( )를 대신하는 함수 
^ _ beginthreadex () S \ _ endthreadex ( )^\, 이 함수들은 머 리 부파일 PROCESS . H 에 
정의되여 있다. _beginthreadex ( ) 의 선언은 다음과 같다. 

unsigned long _beginthreadex (void * secAttr , unsigned stackSize , 
unsigned ( — stdcall * threadFunc ) (void *), 
void * param , unsigned flags , 
unsigned * threadID ) : 

보는바와 같이 _ beginthreadex ( ) 의 파라메터 들은 CreateThread ( )와 같다. 또한 
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매 파라메 터의 의미도 동일하다. secAttr 는 스레 드에 주는 보안속성의 지시자이 다. 그러 
나 secAttr 에 NULL 을 설정 하면 체계설정의 보안서술자가 사용된다. 

새 로운 스레 드의 탄창크기 를 byte 단위 로 stackSize 파라메터 에 설정 한다. 이 값에 
령을 설정하면 스레드를 작성한 프로세스의 기본스레드와 같은 크기의 탄창이 주어 진다. 
이 크기는 후에 필요에 따라 확장할수 있다. 

스레드함수(스레드의 입구점)의 주소를 threadFunc 에 설정한다. _begin 吐 ireadex 
( ) 에서 스레드함수는 다음과 같이 선언되여야 한다. 


unsigned — stdcall threadfunc (void * param ) : 


이 선언은 CreateThreadC ) 에서 사용되는 스레드함수와 기능적으로는 동일하지만 
다른 이 름의 자료형 이 사용된 다. 새 로운 스레 드에 주려 는 파라메터 는 CreateThreadC ) 
의 lParam 파라메터 에 주었 던것 을 그대 로 설정 할수 있 다. 

flags 파라메터는 스레드의 실행상태를 결정 하기 위한것 이 다. 이 파라메터 에 령을 설 
정하면 스레드의 실행이 곧 개시된다. CREATE—SUSPEND 를 설정하면 스레드가 정지상 
태 에서 작성되 여 실행 을 대 기한다. ( ResumeThread ( )를 사용하면 실행 을 개시 할수 있 
다. ) 스레 드를 식 별 하는 ID 가 2배단어 의 지 시 자로 threadID 에 돌려 진다. 

이 함수는 호출이 성공하면 스레드의 손잡이를 돌려 주며 실패하면 령을 돌려 준다. 
_ endthreadex ( ) 의 선언은 다음과 같다. 

void _endthreadex (unsigned status ) : 

이 함수는 ExitThread ( ) 와 완전히 동일 하게 스레 드를 정 지 하는 기 능을 가지 며 
status 에는 완료코드를 설정 한다. 

_ beginthreadex ( )와 _ exitthreadex ( ) 을 사용할 때는 반드시 다중스레 드대 응서 고 
를 련결하는 설정을 해야 한다. 

참고 : Microsoft 는 스 레드 의 작성과 완료 를 진 행 하는 _ beginthread ( ) 및 
_ endthread ( ) 라는 함수도 제공하고 있다. _ beginthread ( ) 는 기본적 인 기능만을 가진 
함수이며 CreateThreadC ) 에서처럼 상세한 조#은 할수 없다. 

Microsoft 의 독자적인 함수들의 사용방법 

c 八>+서고의 스레드와 관련한 함수들의 사용방법을 보기 위 해 앞의 프로그람을 
Microsoft 독 자 의 _beginthreadex ( ) 함 수 를 사 용 하 도 록 변 경 시 켜 보 자 . 
CreateThreadC ) 및 _ beginthreadex ( ) 의 파라메터의 의미와 배 치순서는 갈으므로 아 
래와 갈은 세 가지 변경 만을 진행 한다. 
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• 프로그람에 PROCESS . H 를 포함시 킨다. 

• 스레드함수의 선언을 _begin 仕 ireadex ( ) 에서 사용되는 자료형의 이름으로 변 
경 한다. 

• CreateThread ( ) 의 호출을 _ beginthreadex ( ) 의 호출로 변경한다. 

프로그람에는 다중스레 드대 응의 서 고를 련결하여 야 한다.(그러 자면 [Project 
setting ] 특성 표를 열 고 [ C / C ++] 표쪽을 선 택 하고 [ Category ] 목록칸에 서 [Code 
genera 吐 on ] 을 선택하고 [사용하는 실시간서고] 의 목록칸에서 [Multi Thread ] 를 선택 
한다. ) 변경 을 진행 한 프로그람을 실례 15-2 에 보여 주었 다. 


실 례 15-2. BeginThread 프로그람 

// Microsoft 독자의 _beginthreadex( ) 함수의 사용 

ttinclude 〈 windows. h> 

^include <cstring> 
ttinclude <cstdio> 
ttinclude 〈 process. h> 

^include "thread, h” 

#define MAX 5000 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 

// _beginthreadex( ) 에 요구되는 선언을 사용한다 . 
unsigned _ stdcall MyThreadl (void * param); 
unsigned 一 stdcall MyThread2 (void * param); 

char szWinName[] = ” My Win"; // 창문들라스의 이름 

char str[255 ]； // 표시 할 문자렬을 보관한다 . 

DWORD Tidl, Tid2; // 스레드 ID 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 
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HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 

// 창문물라스를 정의 한다 . 

wcl. cbSize = sizeof (WNDCLASSEX) ; 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이론 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 

wcl. IpszMenuName = "ThreadMenu " ； // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) : 

// 창문콜라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문콜라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Demonstrate Threads", // 제목 

WS_OVERLAPPEDWINDOW, II 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
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NULL, 

NULL, 


hThisInst, 

NULL 


); 


II 어미창문은 없다 . 

// 콜라스차림 표의 덧쓰기는 하지 않는다 . 
// 실체의 손잡이 
// 추가파라메터 는 없 다 . 


// 건반가속기를 적재한다 . 

hAccel = LoadAccelerators (hThisInst, "ThreadMenu") ； 


// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) ； 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

if (! Translate Accelerator (hwnd, hAccel, 技 msg)) { 
TranslateMessage(&msg) ； // 건반통보를 변환한다 . 
DispatchMessage(&msg) ； // Windows 2000 에 조종을 넘 긴다 . 

} 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

int response; 


switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM.THREAD: 

// _beginthreadex( )를 사용하여 스레 드를 작성 한다 . 
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_beginthreadex(NULL, 0, MyThreadl, 

(LPVOID) hwnd, 0, 

(unsigned *) &Tidl) ； 

_beginthreadex(NULL, 0, MyThread2, 

(LPVOID) hwnd, 0, 

(unsigned *) &Tid2) ； 

break ； 

case IDM_EXIT ： 

response = MessageBox(hwnd, ” Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O) ； 
break ； 

case IDM_HELP: 

MessageBox (hwnd, 

” FI: Help\nF2 ： Demonstrate Threads”, 
"Help", MB_OK) ； 

break ； 

} 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default : 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리 률 맡긴 다. */ 
return DefWindowProc(hwnd, message, wParam, lParam); 


return 0 ； 

} 

// 프로세스안에서 실행되는 스레드 
unsigned _ stdcall MyThreadl (void * param) 
{ 

int i; 

HDC hdc ； 
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sprintf(str, ” Thread 1 ： loop # %5d ", i )； 
hdc = GetDC ((HWND) param) ； 
TextOut(hdc, 1, 1, str, strlen(str)) ； 
ReleaseDC ((HWND) param, hdc) ； 

} 


return 0 ； 

} 

// 프로세스안에서 실행되는 또 하나의 스레드 
unsigned — stdcall MyThread2 (void * param) 
{ 

int i ； 

HDC hdc ； 

for(i=0 ； i<MAX ； i++) { 
sprintf(str, "Thread 2 ： loop # %5d ", i) ； 
hdc = GetDC ((HWND) param) ； 
TextOut(hdc, 1, 20, str, strlen(str)) ； 
ReleaseDC ((HWND) param, hdc) ； 

} 


return 0 ； 

} 

C 언어의 표준서고함수들을 대신하는 Win 32 함수들 

많은 다중스레드프로그람은 c 八>+의 표준서고함수를 사용하지 않고도 작성할수 있 
다. 기 억기 잃기를 발생시 킴 이 없이 CreateThread () 와 ExitThread () 를 안심하고 사용 
할수 있다. 

실례 로 이 책 에서 작성하는 많은 실례 프로그람들에서 는 C 언어 의 표준서 고함수를 
sprintf ( ) 와 strlen ( ) 두가지 밖에 사용하지 않고 있 다. Win 32 에 는 이 두 함수를 대 신 
하여 쓰이 는 wsprintfi )와 lstrlen ( ) 라는 함수가 있 다. Win 32 의 함수에 는 Unicode 에 
대응한 확장기능 등이 있으나 기본적인 기능은 C / C ++ 표준서고함수와 동등하다. 

Win 32 에는 이밖에도 lstrcat ( ), lstrcmp ( ) 및 lstrcat ( ) 등 C / C ++ 의 문자렬조작 
함수를 대 신하여 쓰이 는 함수가 몇 개 있다. CharUpper ( ), CharLower ( ), 
IsCharAlpha ( ) 및 IsCharAlphNumericC ) 등과 같은 문자조작용함수들도 많이 있다. 
만일 ( VC ++ 의 표준서고함수를 사용하여 간단한 문자조작만을 진행하고 있으면 그 함수 
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들 대신에 Win32 의 함수를 사용할수도 있다. 

앞으로 이 장에서 작성하는 실례프로그람에서는 CreateThread( )를 사용하여 스레 
드를 작성한다. C/C++ 표준서고함수를 사용하지 않도록 하기 위해 sprintf( )와 
strlen( ) 대신에 wsprintf( )와 lstrlen( )를 사용하기로 한다. 이렇게 하면 앞으로 작성 
하는 실례 프로그람은 Windows 2000 프로그람의 작성 기능을 가진 임의의 C 八>+번역프로 
그람에서도 정확히 번역되고 실행할수 있게 된다. 


스레드의 정지와 재개 


SuspendThread ( 그 를 사 용 하 면 실 행 중 의 스 레 드 를 정 지 시 킬 수 있 다 . 
ResumeThreadC ) 를 사용하면 정 지 중의 스레 드를 재 개 할수 있 다. 이 함수들의 선언은 
다음과 갈다. 


DWORD SuspendThread (HANDLE hThread) ; 
DWORD ResumeThread(HANDLE hThread); 


어 느 함수에 서 나 hThread 에 는 스레 드의 손잡이 를 설정 한다. 

스레드는 정지계수기과는 값을 가지고 있다. 이 계수기가 령인 경우 스레드는 정지 
하고 있지 않으며 령이 아닌 경우는 정지된 상태로 되여 있다. 

SuspendThread( )를 호출하면 정지계수기가 중가된다. ResumeThread( )를 호출 
하면 정지계수기가 감소된다. 정지중의 스레드는 그의 정지계수기가 령으로 되여 있을 
때만 재개된다. 그러므로 정지중의 스레드를 재개하기 위해서는 SuspendThread( ) 를 
호출한 회수와 같은 회수만큼 ResumeThread( )를 호출하여 야 한다. 

이 두개의 함수들은 스레드의 직전의 정지계수기를 돌려 주며 오유가 발생한 경우는 
-1 을 돌려 준다. 


스레드의 우선권순위 


매개 스레드에는 우선권순위 (Priority) 가 설정되 여 있다. 스레드의 우선권순위는 스 
레 드가 얻게 되는 CPU 시 간을 결정한다. 우선권순위 가 낮은 스레드가 얻게 되는 CPU 
시 간은 적 고 순위 가 높은 스레드가 엄 는 CPU 시 간은 많게 된 다. 물론 스레드가 얻 는 
CPU 시간은 그 스레드자체의 동작만이 아니라 체계에서 동시에 실행되고 있는 다른 스 
레 드의 동작에 도 큰 영 향을 미치게 된다. 
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스레드의 우선권순위설정은 두개 값을 조합하여 실시된다. 즉 프로세스전체의 우선 
권순위 클라스와 그 콜라스에 부속된 매 개 스레 드의 우선권순위 이다. 다시 말하여 스레 드 
의 우선권순위 는 프로세 스의 우선권순위클라스와 매 개 스레 드의 우선권순위 를 조합하여 
결정된다. 이 두가지 우선권순위의 의미 에 대 해서는 다음에 설명한다. 

우선권순위클라스 

GetPriorityClass ( )를 사용하면 현재의 우선권순위들라스를 엄을수 있다. 그리고 
SetPriorityClassC ) 을 사용하면 우선권순위콜라스를 설정할수 있 다. 이 함수들의 선언 
은 다음과 갈다. 


DWORD GetPriorityClass (HANDLE hApp ) : 

BOOL SetPriorityClass(HANDLE hApp , DWORD dwPriority ) : 


hApp 에는 프로세스의 손잡이를 설정한다. GetPriorityClass ( ) 는 응용프로그람의 
우선권순위콜라스를 돌려 주며 호출이 실패한 경우에는 령을 돌려 준다. 
SetPriorityClass ( ) 에서 dwPriority 에는 프로세스의 새로운 우선권순위콜라스를 설정 
한다. 우선권순위들라스의 값에는 다음과 같은것들이 있다. 여기에서는 우선권순위가 높 
은 순서 로 보여 주었다. 


REAL _ TIME _ PRIORITY_CLASS 

HIGH _ PRIORITY_CLASS _ 

ABOVE _ NORMAL _ PRIORITY_CLASS (Windows 2000 에 추가된것 ) 
NORMAL _ PRIORITY_CLASS 

BELOW _ NORMAL _ PRIORITY_CLASS (Windows 2000 에 추가된 것 ) 
IDLE _ PRIORITY_CLASS 


프로그람에 는 체 계 설정 으로 NC > RMAL _ PRIORITY_CLASS 가 부여 된 다. 보통은 프로 
그람의 우선권순위들라스를 변경할 필요가 없 다. 실제 적 인 문제 로서 프로세 스의 우선권 
순위콜라스를 변경하는것 으로 인하여 를퓨터 체 계 전체의 성 능에 나쁜 영 향을 주는 경 우들 
이 있다. 

례 하면 프로그람의 우선권순위 콜라스를 REAL _ TIME _ PRIORITY_CLASS 로 승격 시 
키게 되면 그 프로그람이 CPU 시 간을 독점해 버리고 만다. 특수한 목적을 가지는 응용 
프로그람이라면 우선권순위클라스를 승격 시 킬 필요가 있을지 도 모르지 만 일 반적 인 응용 
프로그람에서는 그렇게 할 필요가 없다. 이 장에서는 프로세스의 우선권순위들라스를 체 
계설정값대로 한다. 
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Windows 2000 의 새로운기능: Windows 2000 에는 ABOVE _ NORMAL _ PRIORITY _ 
CLASS 및 BELOW _ NORMAL _ PRIORITY_CLASS 라는 두개의 새로운 우선권순위콜 
라스가 추가되였다. 이 우선권순위클라스에 의해 Windows 2000 에서는 우선권순위를 이 
전보다 더 세밀하게 조종할수 있게 되였다. 

스레드의 우선권순위 

어 느 우선권순위클라스라고 해도 매개 스레드의 우선권순위는 프로세스내 에서 스레 
드가 얻게 되는 CPU 시 간을 결정하는것 으로 된다. 스레 드가 작성되 면 표준적 인 우선권 
순위가 부여된다. 그러나 스레드의 우선권순위는 그것이 실행중이라고 해도 변경시킬수 
있 다. 

GetThreadPriorityC J 를 사용 하면 스레드의 우선권순위를 얻을수 있다. 
SetThreadPriorityC )를 사용하면 스레 드의 우선권순위 를 높이 거 나 낮출수 있 다. 이 함 
수들의 선언은 다음과 같다. 


BOOL SetThreadPriority (HANDLE hThread , int Priority ) : 
int GetThreadPriority (HANDLE hThread ); 


두 함수에 서 hThread 에 는 스레 드의 손잡이 를 설 정 한다. SetThreadPriority () 야 入:\ 
는 Priority 에 새 로운 우선권순위 를 설정 한다. GetThreadPriority () 는 현재 의 우선권순 
위를 돌려 준다. 우선권순위는 다음의 값으로 표시된다. 여기에서는 우선권순위가 높은 
순서로 보여 주었다. 


각 우선권순」 


THREAD — PRIORITY _ TIME_CRmCAL 

15 

THREAD PRIORITY HIGHEST 

2 

THREAD PRIORITY ABOVE NORMAL 

1 

THREAD PRIORITY NORMAL 

0 

THREAD PRIORITY BELOW NORMAL 

-1 

THREAD PRIORITY LOWEST 

-2 

THREAD _ PRIC ) RITY_IDLE 

-15 


이 값들은 프로세스의 우선권순위콜라스의 범위내에서 우선권의 준위를 가리키는 값 
들이 다. Windows 2000 에서는 프로세스의 우선권순위콜라스와 스레 드의 우선권순위를 
조합하여 응용프로그람에 각이한 우선권순위를 설정할수 있다. 

GetThreadPriority ( ) 는 오유가 발생 한 경 우에 THREAD _ PRIORITY _ ERROR _ 
RETURN 을 돌려 준다. 
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대부분의 경우 일반적 인 우선권순위클라스의 스레드라면 스레드의 우선권순위를 변 
경시켜도 체 계전체의 동작에 영 향을 미치는 일은 없다. 다음 절에서 작성하는 스레 드조 
종판을 사용하면 프로세스내 에서 스레 드의 우선권순위설정 을 변경시 킬수 있다. (그러 나 
스레 드의 우선권순위 클라스설정 은 변경 시 킬수 없다. ) 


스레드조종판의 작성 


다중스레드프로그람을 작성할 때는 여 러 가지 우선권순위를 실지 시험해 보는것 이 좋 
다. 또한 스레 드를 정지 , 재개 또는 완료하는것도 시험해 볼수 있다. 이 러 한것들은 지금 
까지 설명해 온 함수들을 리 용하면 간단히 실현할수 있다. 그러 므로 스레 드에 다양한 설 
정 을 진행 하는 스레 드조종판 (Thread control panel ) 을 작성 해 보기 로 한다. 스레 드조종 
판은 다중스레드프로그람의 실행중에 사용하며 그것을 사용하면 스레드의 상태를 변경시 
키고 그 결과를 확인할수 있다. 

이 장에서 작성하는 스레드조종판은 두개의 스레드를 조종할수 있다. 프로그람을 간 
단히 하기 위해 프로그람의 기본스레드의 일부로서 실행되는 양식화대화칸으로서 스레드 
조종판을 작성한다. 여기서는 스레드조종판이 개개의 스레드를 관리하기 위하여 대역적 
인 스레드손잡이를 사용한다. 

스레드조종판에는 다음의 기능들이 있다. 

• 스례드의 우선권순위를 설정한다. 

• 스레드를 정지 한다. 

• 스레드를 재개한다. 

• 스례드를 완료한다. 

스레드조종판에는 매개 스레드의 현재의 우선권순위를 표시하는 기능도 있다. 

이미 설명한것처럼 스레드조종판은 양식화대화칸으로서 작성한다. 양식화대화칸이 
표시될 때는 사용자가 대화칸을 닫을 때까지 응용프로그람의 다른 부분이 정지된 상태로 
된다는것을 상기 해 볼 필요가 있다. 

그러 나 다중스레 드프로그람에 서는 양식 화대 화칸자체 를 하나의 스레드로서 실 행할수 
있다. 이 경우에는 프로그람내의 다른 스레드를 동시에 실행하게 할수 있다. 스레드조종 
판은 프로그람의 기본스레드의 일부로서 실행된다. 그러므로 그자체가 하나의 스레드로 
된 다. 

이 수법의 우점은 비 양식화대화칸보다 간단히 작성 할수 있는 양식화대화칸을 리용해 
서 비양식 화대 화칸과 같은 기능을 실현할수 있다는것 이 다. 여기서는 대 화칸이 하나의 스 
레드로서 작성되므로 비양식화대화칸을 사용할 필요가 없다. 이러한 경험들을 축적해나 
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가느라면 다중스레 드프로그람의 작성 이 지금까지 곤난한것 으로 생각되 던 문제를 해결할 
수 있는 유효한 수단으로 된다는것을 알수 있을것이다. 

스레드조종판의 프로그람코드 

실례 15-3 에 스레드조종판의 사용방법에 대한 실례를 주는 프로그람을 보여 주었다. 
이 프로그람은 앞에 서 작성한 스레 드 실 례프로그람에 대 화칸을 추가한것 이 다. 프로그람 
의 실행결과는 그림 15-2 와 같다. 

이 프로그람을 사용하려면 먼저 [ Thread ] 차림표에서 [Start Thread ] 를 선택하여 스 
레드의 실행을 개시하고 스레드조종판을 표시하여야 한다. 스레드조종판이 표시되면 각이 
한 우선순위를 설정 하거 나 스레드를 정지 하거 나 재 개 하여 그 결과를 확인할수 있다. 

실례 15-3. Panel 프로그람 


//스레드조종판의 리용 

ttinclude < windows. h> 
include ” panel, h” 


ttdefine MAX 50000 

#define NUMPRIORITIES 5 
ttdefine OFFSET 2 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
LRESULT CALLBACK ThreadPaneKHWND, UINT, WPARAM, LPARAM) ； 


DWORD WINAPI MyThreadl (LPVOID param) ； 
DWORD WINAPI MyThread2 (LPVOID param) ； 


char szWinName[] = ’’MyWin”; // 창문믈라스의 이름 

char str[255 ]； // 표시 할 문자렬을 보관한다 . 

DWORD Tidl, Tid2 ； // 스레 드 ID 

HANDLE hThreadl, hThread2 ； // 스레드의 손잡이 

int ThPriorityl, ThPriority2 ； // 스레 드의 우선권순위 
int suspendl = 0, suspend2 = 0 ； // 스레드의 상래 


554 


교육성 프로그람교육쎈터 




제 15 장. 스레드에 기초한 다중과제처리 


char priorities [NUMPRIORITIES] [80] = { 
"Lowest”, 

"Below Normal”, 

"Normal", 

"Above Normal", 

"Highest” 

}； 

HINSTANCE hlnst ； 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg; 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 


// 창문클라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ； 

wcl.hlnstance = hThisInst; // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI.APPLICATION) ； // 큰 아이콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC.ARROW) ； // 유표의 형 식 

wcl. IpszMenuName = "ThreadPanelMenu” ; // 기본차림 표 

wcl.cbClsExtra = 0; // 보조기억기령역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ； 
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// 창문콜라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문콜라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Using a Thread Control Panel", // 제목 
WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CW_USEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJUSEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 믈라스차림 표의 덧쓰기는 하지 않는다 . 

hThisInst, // 실체의 손잡이 

NULL // 추가파라메 터 는 없 다 . 

)； 


hlnst = hThisInst ； // 실체의 손잡이를 보관한다 . 

// 건반가속기를 적재 한다 . 

hAccel = LoadAccelerators (hThisInst, "ThreadPanelMenu") : 

// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) ; 

UpdateWindow (hwnd ); 


II 통보문순환고리를 작성 한다 . 

while(GetMessage(&msg , NULL, 0, 0)) 

{ 

if (! TranslateAccelerator (hwnd, hAccel, &msg)) { 
TranslateMessage(&msg); // 건반통보를 변환한다 . 
DispatchMessage(&msg) ; // Windows 2000 에 조종을 넘 긴 다 . 

} 

} 
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return msg. wParam ； 

} 


/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

int response ； 


switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM_THREAD ： // 스 레드를 작성한다 . 
suspendl = suspend2 = 0 ； 
hThreadl = CreateThread (NULL, 0, 

(LPTHREAD_START_ROUTINE) MyThreadl, 
(LPVOID) hwnd, 0, &Tidl) ； 
hThread2 = CreateThread (NULL, 0, 

(LPTHREAD_START_ROUTINE) MyThread2, 
(LPVOID) hwnd, 0, &Tid2) ； 

break ； 

case IDM.PANEL ： // 스레드조종판을 표시 한다 . 

DialogBox(hlnst, "ThreadPanelDB", hwnd, 

(DLGPROC) ThreadPanel); 

break ； 

case IDM.EXIT ： 

response = MessageBox(hwnd, "Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O); 
break ； 

case IDM_HELP: 

MessageBox (hwnd, 

” FI: Help\nF2 ： Start Threads\nF3 ： Panel", 

” Help”, MB_OK) ； 

break ； 

} 
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break ； 

case WM_DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ; 
break ； 
default : 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리 률 맡긴 다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 


return 0 ； 


U 프로세스안에서 실행되는 스레드 

DWORD WINAPI MyThreadKLPVOID param) 


int i; 

HDC hdc ； 

for(i=0 ； i<MAX ； i++) { 
wsprintf(str, "Thread 1 ： loop # %5d ", i) ； 
hdc = GetDCC(HWND) param); 
TextOut(hdc, 1, 1, str, lstrlen(str)) ； 
ReleaseDC((HWND) param, hdc )； 

} 


return 0 ； 


V 프로세스안에서 실행되는 다른 하나의 스레드 
DWORD WINAPI MyThread2 (LPVOID param) 


int i ； 

HDC hdc ； 

for(i=0 ； i<MAX; i++) { 
wsprintf(str, "Thread 2: loop # %5d i); 

hdc = GetDC ((HWND) param) ； 
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TextOut(hdc, 1, 20, str, lstrlen(str)) ； 
ReleaseDC ((HWND) param, hdc) ； 

} 


return 0 ； 

} 

// 스레드조종판의 대화칸 

LRESULT CALLBACK ThreadPanel (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

long i ； 

HWND hpbRes, hpbSus ； 

switch (message) { 
case WMJNITDIALOG ： 

// 목록칸을 초기화한다 . 

for(i=0 ； KNUMPRIORITIES ； i++) { 

SendDlgltemMessage (hdwnd, IDD_LB1, 

LB.ADDSTRING, 0, (LPARAM) priorities [i]) ； 
SendDlgltemMessage (hdwnd, IDD_LB2, 

LB.ADDSTRING, 0, (LPARAM) priorities [i]) ； 

} 

// 현재의 우선권순위를 얻는다 . 

ThPriorityl = GetThreadPriority (hThreadl) + OFFSET ； 
ThPriority2 = GetThreadPriority (hThread2) + OFFSET ； 

// 목록칸을 갱 신한다 . 

SendDlgltemMessage (hdwnd, IDD_LB1, LB_SETCURSEL, 
(WPARAM) ThPriorityl, 0 )； 

SendDlgltemMessage (hdwnd, IDD_LB2, LB_SETCURSEL, 
(WPARAM) ThPriority2, 0); 

// 첫번째 스레드용의 [Suspend 1] 및 [Resume 1] 단추를 설정한다 . 
hpbSus = GetDlgItem(hdwnd, IDD_SUSPEND1) ; 
hpbRes = GetDlgItem(hdwnd, IDD.RESUMEl) ； 
if(suspendl) { 
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EnableWindow (hpbSus , 0) ; II 
EnableWindow (hpbRes, 1) ； // 

} 

else { 

EnableWindow (hpbSus, 1) ； // 
EnableWindow (hpbRes, 0); // 


[Suspend 1] 단추를 무효로 한다 . 
[Resume 1] 단추를 유효로 한다 . 


[Suspend 1] 단추를 유효로 한다 . 
[Resume 1] 단추를 무효로 한다 . 


// 두번째 스레드용의 [Suspend 2] 및 [Resume 2] 단추를 설정한다 . 
hpbSus = GetDlgItem(hdwnd, IDD_SUSPEND2) ; 
hpbRes = GetDlgltem (hdwnd, IDD_RESUME2) ； 


if (suspend2) { 

EnableWindow (hpbSus, 0); // 
EnableWindow (hpbRes, 1) ； // 

} 

else { 

EnableWindow (hpbSus, 1) ； // 
EnableWindow (hpbRes, 0); // 


[Suspend 2] 단추를 무효로 한다 . 
[Resume 2] 단추를 유효로 한다 . 


[Suspend 2] 단추를 유효로 한다 . 
[Resume 2] 단추를 무효로 한다 . 


return 1 ； 

case WM.COMMAND ： 
switch (wParam) { 

case IDD.TERMINATEl ： 

TerminateThread (hThreadl, 0); 
return 1 ； 

case IDD.TERMINATE2 ： 

TerminateThread (hThread2, 0); 
return 1 ； 

case IDD.SUSPENDl ： 

SuspendThread (hThreadl) ； 

hpbSus = GetDlgltem (hdwnd, IDD_SUSPEND1) ； 

hpbRes = GetDlgltem (hdwnd, IDD_RESUME1) ； 

EnableWindow (hpbSus, 0); // [Suspend 1] 단추률 무효로 한다 . 
EnableWindow (hpbRes, 1); // [Resume 1] 단추를 유효로 한다 . 
suspendl = 1; 
return 1; 

case IDD_RESUME1: 
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ResumeThread (hThreadl) ； 

hpbSus = GetDlgItem(hdwnd, IDD_SUSPEND1) ； 

hpbRes = GetDlgltem (hdwnd, IDD_RESUME1); 

EnableWindow(hpbSus, 1); // [Suspend 1] 단추를 유효로 한다 . 
EnableWindow(hpbRes, 0); // [Resume 1] 단추를 무효로 한다 . 
suspendl = 0 ； 
return 1; 

case IDD_SUSPEND2 : 

SuspendThread (hThread2) ； 

hpbSus = GetDlgltem (hdwnd, IDD_SUSPEND2); 

hpbRes = GetDlgltem (hdwnd, IDD_RESUME2) ； 

EnableWindow (hpbSus, 0); // [Suspend 2] 단추를 무효로 한다 . 
EnableWindow (hpbRes, 1 )； // [Resume 2] 단추를 유효로 한다 . 
suspend2 = 1; 
return 1; 

case IDD.RESUME2 ： 

ResumeThread (hThread2) ； 

hpbSus = GetDlgltem (hdwnd, IDD_SUSPEND2); 

hpbRes = GetDlgltem (hdwnd, IDD_RESUME2); 

EnableWindow (hpbSus, 1); // [Suspend 2] 단추를 유효로 한다 . 
EnableWindow (hpbRes, 0); // [Resume 2] 단추를 무효로 한다 . 
suspend2 = 0 ； 
return 1 ； 

case IDOK ： // 우선권순위를 변경한다 . 

ThPriorityl = SendDlgltemMessage (hdwnd, IDD_LB1, 
LB.GETCURSEL, 0, 0); 

ThPriority2 = SendDlgltemMessage (hdwnd, IDD_LB2, 
LB.GETCURSEL, 0, 0); 

SetThreadPriority (hThreadl, ThPriority 1-OFFSET); 
SetThreadPriority (hThread2, ThPriority2-OFFSET); 
return 1; 
case IDCANCEL ： 

EndDialog (hdwnd, 0); 
return 1 ； 



return 0 ； 


} 
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이 프로그람은 아래 와 같은 내 용의 PANEL . H 라는 머 리부파일을 사용한다. 


#define IDM.THREAD 100 

Mefine IDM.HELP 101 

ttdefine IDM_PANEL 102 

#define IDM.EXIT 103 

#define IDD_LB1 200 

Mefine IDD.LB2 201 

Mefine IDD.TERMINATEl 202 

#define IDD_TERMINATE2 203 

Mefine IDD_SUSPEND1 204 

Mefine IDD_SUSPEND2 205 

#define IDD_RESUME1 206 

Mefine IDD.RESUME2 207 

Mefine IDD.TEXTl 208 

#define IDD_TEXT2 209 

Mefine IDD_TEXT3 210 


이 프로그람에서 사용되는 자원파일의 내용을 아래에 보여 주었다. 

ttinclude < windows. h> 
include "panel, h” 

ThreadPanelMenu MENU 

{ 

POPUP ，， &Threads” { 

MENUITEM n &Start Threads \tF2”, IDM.THREAD 
MENUITEM ’'^Control Panel \tF3", IDM—PANEL 
MENUITEM ” E&xit\tCtrl+X", IDM_EXIT 

} 

MENUITEM M &Help M , IDM.HELP 

} 

ThreadPanelDB DIALOGEX 20, 20, 170, 140 
CAPTION ” Thread Control Panel" 

STYLE DS_MODALFRAME | WS.POPUP | WS.CAPTION | WS.SYSMENU 

{ 
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DEFPUSHBUTTON "Change", IDOK, 80, 105, 33, 14 
PUSHBUTTON ” Done，，, IDCANCEL, 15, 120, 33, 14 
PUSHBUTTON "Terminate 1 M , IDD_TERMINATE1, 10, 10, 42, 12 
PUSHBUTTON ” Terminate 2", IDD.TERMINATE2, 10, 60, 42, 12 
PUSHBUTTON ” Suspend 1 M , IDD_SUSPEND1, 10, 25, 42, 12 
PUSHBUTTON "Resume 1”, IDD.RESUMEl, 10, 40, 42, 12 
PUSHBUTTON ” Suspend 2", IDD.SUSPEND2, 10, 75, 42, 12 
PUSHBUTTON "Resume 2" ， IDD.RESUME2, 10, 90, 42, 12 
LISTBOX IDD.LBl, 65, 11, 63, 42, LBS_NOTIFY | WS.VISIBLE | 
WS_BORDER | WS.VSCROLL | WS.TABSTOP 
LISTBOX IDD.LB2, 65, 61, 63, 42, LBS.NOTIFY | WS.VISIBLE | 
WS_BORDER | WS—VSCROLL | WS.TABSTOP 
CTEXT ” Thread l n , IDD.TEXTl, 140, 22, 24, 18 
CTEXT ” Thread 2”, IDD.TEXT2, 140, 73, 24, 18 
CTEXT ” Thread Priority”, IDD.TEXT3, 65, 0, 64, 10 

} 

ThreadPanelMenu ACCELERATORS 

{ 

VK_F1, IDM_HELP, VIRTKEY 
VK_F2, IDM.THREAD, VIRTKEY 
VK_F3, IDM.PANEL, VIRTKEY 
『 X", IDM_EXIT 

} 



그림 15-2. 스레드조종판의 실행 a 과 
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스레드조종판의 상세 

스레드조종판의 내용을 자세히 살펴 보자. 프로그람의 선두에서는 스레드조종판에서 
리용되는 몇개의 대역변수가 선언되여 있다. 

DWORD Tidl, Tid2 ； // 스레 드 ID 

HANDLE hThreadl, hThread2 ； // 스레드손잡이 

int ThPriorityl, ThPriority2 ； // 스레 드의 우선권순위 
int suspendl = 0, suspend2 = 0 ； // 스레드의 상래 

char priorities [NUMPRIORITIES] [80] = { 

"Lowest", 

” Below Normal", 

"Normal", 

"Above Normal", 

” Highest" 

}； 


Tidl 과 Tid 2 는 두 스레 드의 ID 를 보관한다. hThreadl 과 hThread 2 는 두 스레 드 
의 손잡이를 보관한다. 이 손잡이에는 CreateThread () 로 스레드를 작성했을 때의 돌림 
값이 보관된다. ThPriorityl 과 ThPriority 2 는 두 스레드의 현재의 우선권순위를 보관한 
다. suspendl 과 suspend 2 는 두 스레 드의 상태 를 보관하는데 사용된다. 배 렬 priorities 
는 스레드조종판에서 사용되는 목록칸을 초기화하는 문자렬을 보관하고 있다. 이 문자렬 
은 우선권순위를 보여 주는것들이 다. 

프로 그람에 는 다음의 마크로들도 정의되여 있다. 

ttdefine NUMPRIORITIES 5 

#define OFFSET 2 

NUMPRIORITIES 는 설정가능한 우선권순위의 개수를 가리키는 마크로이 다. 스레 
드조종판을 사용하여 설정할수 있는 스레 드의 우선권순위 는 다음과 같다. 

THREAD _ PRIORITY_HIGHEST 

THREAD _ PRIORITY _ ABOVE_NORMAL 

THREAD _ PRIORITY_NORMAL 

THREAD _ PRIORITY _ BELOW_NORMAL 

THREAD _ PRIORITY_LOWEST 
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다음의 두개 의 우선권순위 는 설 정할수 없 다. 왜 냐하면 이 두개 의 우선권순위 가 스레 
드조종판에서는 거의나 의미 를 가지지 않기때 문이 다. 례 를 들어 만일 스레 드의 우선권순 
위 에 THREAD _ PRIORITY _ TIME_CRITICAL 을 설 정 하는 응용프로그람을 작성 한다면 
우선권순위 콜라스에 REALTIME _ PRI (〕 RITY_CLASS * 설 정 하는 편 이 더 유익 하기 때 문 
이다. 

THREAD _ PRIORITY _ TIME_CRITICAL 

THREAD _ PRIORITY_IDLE 

OFFSET 는 목록칸의 색 인값을 스레드의 우선권순위의 값으로 변환하기 위한것 이 다. 

THREAD _ PRIORITY_NORMAL 악 값이 령 이 라는것 을 기 억 하고 있을것 이 다. 이 프 
로그람에 서 는 가장 높은 우선권순위 가 THREAD _ PRIORITY_HIGHEST (값은 2) 이 며 
제 일 낮은 우선권순위가 THREAD _ PRIORITY_LOWEST (값은 -2) 로 되 여 있다. 목록 
칸의 색 인은 령으로부터 시작되므로 색 인값에서 OFF 況: T (값은 2) 를 덜면 우선권순위값 
으로 변환할수 있다. 

스레드 조종판의 대 화함수는 다음과 같다. 

//스레드조종관의 대화칸 

LRESULT CALLBACK ThreadPanel (HWND hdwnd, UINT message, 

WPARAM wParam, LPARAM IParam) 

{ 

long i ； 

HWND hpbRes, hpbSus ； 


switch (message) { 
case WMJNITDIALOG ： 

// 목록칸을 초기화한다 . 

for(i=0; KNUMPRIORITIES ； i++) { 

SendDlgltemMessage (hdwnd, IDD_LB1, 

LB_ADDSTRING, 0, (LPARAM) priorities [i]) ； 
SendDlgltemMessage (hdwnd, IDD_LB2, 

LB_ADDSTRING, 0, (LPARAM) priorities [i]); 

} 

// 현재의 우선권순위를 얻는다 . 

ThPriorityl = GetThreadPriority (hThreadl) + OFFSET ； 
ThPriority2 = GetThreadPriority (hThread2) + OFFSET ； 
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// 목록칸을 갱 신한다. 

SendDlgltemMessage (hdwnd, IDD_LB1, LB_SETCURSEL, 
(WPARAM) ThPriorityl, 0); 

SendDlgltemMessage (hdwnd, IDD_LB2, LB_SETCURSEL, 
(WPARAM) ThPriority2, 0); 


// 첫번째 스레드용의 [Suspend 1] 및 [Resume 1] 단추를 설정한다 . 
hpbSus = GetDlgItem(hdwnd, IDD_SUSPEND1) ; 


hpbRes = GetDlgItem(hdwnd, IDD.RESUMEl) ； 


if(suspendl) { 

EnableWindow (hpbSus, 0); // 
EnableWindow(hpbRes, 1); // 

} 

else { 

EnableWindow (hpbSus, 1); // 
EnableWindow (hpbRes, 0) ； // 


[Suspend 1] 단추를 무효로 한다 . 
[Resume 1] 단추률 유효로 한다 . 


[ Suspend 1] 단추를 유효로 한다 . 
[Resume 1] 단추를 무효로 한다 . 


// 두번째 스레드용의 [Suspend 2] 및 [Resume 2] 단추를 설정한다 . 
hpbSus = GetDlgItem(hdwnd, IDD_SUSPEND2) ; 
hpbRes = GetDlgItem(hdwnd, IDD.RESUME2) ； 


if(suspend2) { 

EnableWindow (hpbSus, 0); // 
EnableWindow (hpbRes, 1); // 


} 

else { 

EnableWindow (hpbSus, 1); // 
EnableWindow (hpbRes, 0); // 

} 

return 1 ； 

case WM.COMMAND ： 
switch (wParam) { 
case IDD.TERMINATEl ： 


[Suspend 2] 단추를 무효로 한다 . 
[Resume 2] 단추률 유효로 한다 . 


[ Suspend 2] 단추를 유효로 한다 . 
[Resume 2] 단추를 무효로 한다 . 


TerminateThread (hThreadl, 0) ； 
return 1; 

case IDD.TERMINATE2 ： 
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TerminateThread (hThread2, 0); 
return 1 ； 

case IDD.SUSPENDl ： 

SuspendThread (hThreadl) ； 

hpbSus = GetDlgItem(hdwnd, IDD.SUSPENDl) ； 

hpbRes = GetDlgltem (hdwnd, IDD_RESUME1) ； 

EnableWindow(hpbSus, 0); // [Suspend 1] 단추를 무효로 한다 . 
EnableWindow(hpbRes, 1); // [Resume 1] 단추를 유효로 한다 . 
suspendl = 1 ； 
return 1; 

case IDD_RESUME1: 

ResumeThread (hThreadl); 

hpbSus = GetDlgltem (hdwnd, IDD_SUSPEND1) ； 

hpbRes = GetDlgltem (hdwnd, IDD.RESUMEl) ； 

EnableWindow (hpbSus, 1); // [Suspend 1] 단추를 유효로 한다 . 
EnableWindow (hpbRes, 0 )； // [Resume 1] 단추를 무효로 한다 . 
suspendl = 0 ； 
return 1; 

case IDD_SUSPEND2 ： 

SuspendThread (hThread2) ； 

hpbSus = GetDlgltem (hdwnd, IDD_SUSPEND2) ； 

hpbRes = GetDlgltem (hdwnd, IDD_RESUME2); 

EnableWindow (hpbSus, 0); // [Suspend 2] 단추를 무효로 한다 . 
EnableWindow (hpbRes, 1); // [Resume 2] 단추를 유효로 한다 . 
suspend2 = 1 ； 
return 1 ； 

case IDD.RESUME2 ： 

ResumeThread (hThread2); 

hpbSus = GetDlgltem (hdwnd, IDD_SUSPEND2) ； 

hpbRes = GetDlgltem (hdwnd, IDD.RESUME2) ； 

EnableWindow (hpbSus, 1); // [Suspend 2] 단추를 유효로 한다 . 
EnableWindow (hpbRes, 0); // [Resume 2] 단추를 무효로 한다 . 
suspend2 = 0 ； 
return 1; 

case IDOK ： // 우선권순위를 변경한다 . 

ThPriorityl = SendDlgltemMessage (hdwnd, IDD_LB1, 
LB.GETCURSEL, 0, 0); 

ThPriority2 = SendDlgltemMessage (hdwnd, IDD_LB2, 
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LB_GETCURSEL, 0, 0 )； 

SetThreadPriority (hThreadl, ThPriority 1-OFFSET); 
SetThreadPriority (hThread2, ThPriority2-OFFSET); 
return 1; 
case IDCANCEL ： 

EndDialog (hdwnd, 0); 
return 1 ； 



return 0 ； 

} 

스레드조종판이 표시되면 다음의 순서로 처리가 진행된다. 

① 스레 드조종판에서 사용되는 두개의 목록칸을 초기화한다. 

② 두 스레드의 현재의 우선권순위를 얻는다. 

③ 두 스레드의 우선권순위를 목록칸에 반전표시 한다. 

© 스레드가 정 지된 경우는 스레 드의 [ Suspend ] 단추를 무효로 한다. 스레 드가 실 
행중인 경우는 스레드의 [ Resume ] 단추를 무효로 한다. 

대 화칸이 초기 화되 면 목록칸에서 새 로운 우선권순위 를 선택 하고 [ Change ] 단추를 
눌러서 스레드의 우선권순위를 변경시킬수 있다. 

[ Suspend ] 단추를 누르면 스레 드를 정지시킬수 있다. 대역변수 suspendl 및 
suspend 2 에는 매개 스레드의 현재상태가 보관된다. 변수의 값이 령이면 스레드가 실행 
중이라는것을 가리킨다. 령이 아니면 스레드가 정지상태라는것을 가리킨다. 

정지 중의 스레 드를 재 개 하려 면 [ Resume ] 단추를 누른다. suspendl 과 suspend 2 는 또 
한 대화칸이 초기화될 때 [ Suspend ] 단추를 무효로 하는 역할도 한다. 어떤 스레드에 있 
어서나 그것을 재개하려면 SuspendThread ( ) 의 호출과 같은 회수로 ResumeThread ( ) 
를 호출해야 한다는것을 잊지 말아야 한다. 정지된 스레드의 [ Suspend ] 단추를 무효로 하 
여 SuspendThread ( ) 가 다시 호출되는것을 방지할수 있다. 

스레드의 실행중에도 스레드조종판을 열거나 닫을수 있으므로 대화칸이 초기화될 때 
마 다 [ Suspend ] 및 [ Resume ] 단추의 상태 를 적 절 히 설 정 해 야 한 다 . suspendl 과 
suspend 2 의 두 변수는 새로운 스레드가 개시될 때마다 령으로 재설정된다. 

[ Terminate ] 단추를 누르면 스레 드를 정지 시 킬수 있다. 스레 드가 정지되면 그것 을 
재 개할수 있다. 스레 드조종판에서는 스레 드를 정지시키는데 TerminateThreadC ) 을 사 
용하고 있는 점 에 주의 를 돌려야 한다. 이 장을 시 작하면서 설명 한것 처 럼 이 함수는 주 
의 하여 사용해 야 하는 함수이다. 그러 나 스례 드조종판을 사용하여 스레 드의 조종을 시 험 
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하는것 뿐이라면 특별 히 문제 가 발생 하지 는 않을것 이 다. 

앞으로 더 나아가기전에 스레드 조종판을 사용하여 여러가지 우선권순위의 효과 등을 
실제로 확인해 보는것이 유익하다. 


|다시 한보 전진| 


기본스레드의 우선권순위의 변경 

스레드조종판을 사용해 보거나 그것에 대한 설명을 읽으면 한가지 의문점이 
생길것이다. 그것은 스레드조종판이 왜 프로그람에서 작성된 두개의 스레드만을 
조종하는가? 어째서 세개는 아닌가? 하는 의문이다. 

모든 프로그람은 적어도 하나의 스레드를 가지며 그것을 기본스레드라고 부 
른다는것을 상기해 볼 필요가 있다. 실례프로그람에 있어서 기본스레드는 프로그 
람의 실행중에 동시에 동작하는 세개의 스레드로 되여 있다. 그러나 기본스레드 
를 스레 드조종판에서 조종할수는 없다. 그 리유는 두가지 이 다. 

첫째 리유는 보통 기 본스레 드의 우선권순위 를 변경 시 킬 필요가 없 다는것 이 
다. 추가된 스레드의 우선권순위만을 변경하는것이 일반적이다. 두번째 리유는 
스레드와 관련된 모든 조종을 기본스레드에 대해서 진행할수 없기때문이다. 실례 
로 기본스레드를 정지시키면 프로그람자체를 완료할수 없게 되 여 버리고 만다. 
더우기 스레드조종판으로 되여 있는 대화칸이 기본스레드의 일부이므로 만약 기 
본스레 드를 정지시키면 그것을 재개할 수단이 없게 되 여 버리고 만다. 

이 려 한 리 유 들 로 부 터 기 본 스 레 드 는 체 계 설 정 ( THREAD _ PRIORITY _ 
NORMAL ) 그대 로 실 행 해 야 하는것 이 다. 

그러 나 기 본스레 드의 우선권순위 를 참조하거 나 변경하는것 이 불가능하다는것 
은 아니다. 기본 스레드 의 손잡이를 엄으면 그것이 가능 하다. 
GetCurrentThread ( ) 를 사용하면 기 본스레 드의 손잡이 를 얻 을수 있 다. 선언은 
다음과 갈다. 

HANDLE GetCurrentThread ( void ) ; 

GetCurrentThreadC ) 는 현재스레드의 의사손잡이를 돌려 준다. 이 의사손 
잡이를 일반적인 손잡이가 설정되는 임의의 장면에서 사용할수 있다. 

기 본스례 드의 우선권순위 를 변경 시 킨 효과를 확인하려 면 스레 드조종판프로그 
람에서 IDM_THREAD 의 case 문부분을 다음과 같은 프로그람코드로 치환하고 
hThread 2 에 기 본스레 드의 손잡이 가 설정되도록 하면 된다. 

hThreadl = CreateThread(NULL, 0, 

(LPTHREAD_START_ROUTINE) MyThreadl, 
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(LPVOID) hwnd, 0, &Tidl) ; 

CreateThread(NULL, 0, 

(LPTHREAD_START_ROUTINE)MyThread2, 

(LPVOID) hwnd, 0, &Tid2); 

//； hThread2 에 기 본스레 드의 손잡이 를 설정 한다 . 
hThread2 = GetCurrentThread ( ) ； 

프로그람을 실행하고 스레드조종판을 표시하면 Thread 2 는 기본스레드를 표 
시하게 된다. 그러나 주의해야 한다. 만약 기본스레드를 정지시켜 버리면 과제관 
리자를 사용하지 않고서는 프로그람을 완료할수 없게 된다. 


동 기 화 


다중스레드나 다중프로세스를 사용하는 경우에는 그것들의 동작을 협조해야 할 펼요 
가 제기되는 경우가 있다. 이것을 동; V 호/라고 한다. 동기화가 리용되는 가장 일반적인 
장면은 두개이상의 스레드가 공유자원을 호출할 필요가 제기되는 경우에 그 공유자원에 
는 동시에 한개의 스레드밖에 호출할수 없는 때 이다. 

례하면 첫 스례드가 파일의 쓰기를 진행하고 있을 때는 두번째 스레드가 같은 파일 
을 동시 에 호출하는것을 방지 하여 야 한다. 이 문제를 해결하기 위 한 방법을 순차화라표 
한다. 

동기화가 필요되는 다른 장면으로서 한 스레드가 다른 스레드에 의해 발생되는 사건 
을 대기하고 있는 때가 있다. 이런 경우에는 목적하는 사건이 발생할 때까지 첫 스레드 
를 정지상태로 방임해 놓기 위한 어떤 수단이 필요하게 된다. 그러다가 사건이 발생하면 
스레드를 재 개 하여 야 한다. 

우선 몇가지 용어를 정의해 두자. 과제에는 기본적으로 두개의 상태가 있다. 첫번째 
상태는 실행상태 (또는 시간구획 (time slice ) 이 할당되면 곧 실행을 개시할수 있는 상태) 
이다. 두번째 상태는 차단상태이다. 이것은 필요한 자원에 대한 호출이 가능하게 되든가 
혹은 목적 하는 사건 이 발생 할 때 까지 실 행 이 정 지 되 여 있 는 상태 이 다. 

만약 동기화나 순차화문제와 관련한 지식이 없으면 다음 절에서 가장 일반적인 동기 
화의 해결책인 스/호 7/( semaphore ) 에 대한 설명을 읽으면 된다. (충분한 지식을 소유하고 
있는 사람은 이 절을 뛰여 넘어도 된다.) 

동기화의 문제점과 해결책 

공유자원을 호출하기 위 한 순차화기능을 제공하는것은 Windows 2000 의 임무로 된 
다. 그것은 조작체계의 방조가 없으면 스레드나 프로세스는 자원이 다른 스레드 혹은 프 
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로세스로부터 호출되는가 아닌가를 알수 없기때문이다. 

이 문제를 리 해 하기 위해 순차화를 지 원하지 않는 조작체계 에서 다중과제 프로그람을 
작성한 경 우를 고찰해 보자. 

동시에 실행되는 A 혹은 B 라는 프로세스가 있고 그것들이 때때로 R 라는 자원 (디스 
크상의 파일 등)을 호출한다고 하자. 이 자원을 호출할수 있는것은 동시에 하나의 프로 
세스 또는 스레드뿐이다. 한 프로세스가 R 를 호출하고 있을 때 다른 프로세스로 부터의 
호출을 방지하기 위한 수단으로서 다음과 같은것을 시험해 보자. 

우선 량쪽의 프로세스에서 모두 참조할수 있는 flag 라는 변수를 준비한다. 한 프로세 
스가 flag 를 령 으로 초기 화한다. 다음으로 묘 를 호출하는 프로세 스는 flag 가 령 으로 재 설 
정되여 있는가를 확인하고 나서 flag 를 1 로 설정하고 자원 R 를 호출한다. 마지막으로 
flag 를 령 으로 복귀시 킨다. 이 리 하여 묘 를 호출하는 프로그람코드는 다음과 같이 된다. 

while (flag )： // flag 가 령으로 재설정되기를 기다린다 . 

flag = 1; //flag 를 1 로 설정한다 . 

II.... 자원 요를 호출한다 . 

flag = 0 ； // flag 를 령으로 재설정한다 . 

이 수법의 요점은 flag 에 1 이 설정되여 있는 경우에는 다른 프로세스가 묘를 호출할 
수 없다는것이다. 이 수법은 정당한것처럼 생각된다. 그런데 실제로는 단순한 리유로부 
터 항상 정 확하게 동작한다고는 단정 할수 없 다. 그 리유를 설명 해 보자. 

이 프로그람코드를 사용하면 량쪽의 프로세스가 동시 에 묘 를 호출하는것 이 가능하게 
되여 버 리고 만다. while 순환에서는 flag 값의 적재와 참조가 반복되고 있다. 즉 flag 
의 값이 검사되고 있다. flag 의 값이 0 으로 재설정되여 있는 경우는 프로그람의 다음 행 
에 서 flag 의 값이 1 로 설정된다. 

문제로 되는것은 이 두 처리가 다른 시간구획에서 실행된다는것이다.두 시간구획의 
사이 에 다른 프로세스가 flag 의 값을 참조할수 있다. 그러므로 량쪽의 프로세스가 R 를 
동시에 호출할수 있게 된다. 

이 문제를 보다 상세히 설명해 보자. 프로세스 A 가 while 순환에 들어 가 flag 가 
령인가를 검 사한다. 다시말하여 묘 의 호출이 가능하다는 것 을 알게 된다. 그런데 프로세 
스 A 가 flag 를 1 로 설정하기전에 그의 시간구획이 끝나면 프로세스 B 의 실행이 재개된 
다. 만일 프로세스 B 가 while 순환을 실행 하였 다면 flag 가 설정 되 여 있지 않 으므로 R 
를 호출하여도 문제가 없다고 판정해 버러고 만다. 그러나 프로세스 A 의 실행이 재개 되 
면 묘는 호출되고 만다. 

이 문제의 위험성은 flag 의 검사와 설정이 다른 처리에 의해 새치기된다는것이다. 
이미 설명한것처럼 flag 의 검사와 설정은 서로 다른 시간구획으로 된다. 어떠한 고안을 
한다고 해도 응용프로그람의 프로그람코드를 사용하는 한에 있어서는 R 를 동시에 호출 
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하는것 이 반드시 하나의 프로세스 만이라고 확인할수 없는것 이다. 

동기 화와 관련한 문제는 단순한것 이 므로 그의 해 결책 도 명쾌하다. 그것 은 조작체 계 
(여기 에서는 Windows 2000) 가 다른것에 의해 새 치기되지 않는 하나의 처 리 안에서 기 발 
의 참조와 설정을 진행하는 기능을 제공하면 되는것이다. 

조작체계전문가들은 이 기능을 <검사 및 설정조작>이라고도 한다. 력사적 인 경위 로 
부터 순차화를 조종하는데 사용되며 스레 드(또는 프로세스)간 동기화를 보장하는 기능을 
제공하는 기 발을 스/호7八 semaphore ) 라고 부론다. 신호기는 Windows 2000 이 순차화를 
실현하는데서 핵심으로 된다. 


Windows 2000 으 I 동기화객체 


Windows 2000 은 다섯가지 종류의 동기화객체를 제공하고 있다. 

첫 번째 동기 화객 체 는 고전적 인 신호기 이다. 신호기 는 자원을 호출할수 있는 프로세 
스나 스레드의 수를 제한할수 있게 한다. 신호기를 사용하면 자원이 완전히 순차화되며 
동시에 하나의 스레드 혹은 프로세스만이 호출할수 있게 된다. 그러나 신호기는 동시에 
호출할수 있는 스레드나 프로세스를 한개이상의 임의의 수로 설정할수도 있다. 

신호기는 계수기형식으로 실현된다. 이 계수기는 과제에 신호기가 전달되였을 때 증 
가되며 과제가 신호기를 해제했을 때 감소된다. 

두번째 동기 화객 체 는 2값신호기 (Mutex semaphore ) 이 다. 2 값신호기 는 자원을 순차 
화하는데 사용되며 동시에 호출할수 있는 스레드 혹은 프로세스를 한개만으로 제한한다. 
2값신호기는 일반적 인 신호기의 특수한 형식 이 다. 

세 번째 동기화객체는 사건적체이 다. 사건객체는 다른 스레드나 프로세스로부터 자원 
을 사용해도 좋다는 신호가 올 때까지 자원에 대 한 호출을 차단하는데 사용된다. (이것은 
사건객체가 특정의 사건의 발생에 대해 통지한다는것 이 다.) 

네번째 동기화객체는 기다림시계이다. 기다림시계는 특정한 시간동안 스레드의 실행 
을 차단한다. 기 다림시계는 배경으로 실행되는 과제 에서 특히 효과를 발휘한다. 

다섯 번째 동기 화객 체 는 량/^/구 ^(Critical section ) 이다. 림계 구역 객체를 리 용하여 프 
로그람의 부분적코드를 림계구역으로 하면 그것이 동시에 한개이상의 스레드에서 실행되 
는것을 방지할수 있다. 한 스레드가 림계구역의 실행을 개시하면 그것의 실행이 끝날 때 
까지 다른 스레 드로부터 실행 할수 없게 된 다. (림 계 구역은 프로세 스내 의 스레 드에 만 적 용 
된 다.) 

림계구역 을 제외 한 동기화객체 들은 프로세 스안의 스레 드와 프로세 스자체 에 적 용할수 
있다. 실제로는 부분적인 통신수단으로서 가장 간단한 신호기가 잘 사용된다. 

이 장에서는 신호기，사건객체 및 기다림시계의 작성방법과 사용방법에 대해 설명한 
다. 이 동기화객체들을 리해하게 되면 2 값신호기나 림계구역에 대해서도 자체로 정통할 
수 있을것 이다. 

모든 동기화객체들의 핵심구조는 그것을 직접 사용하는가 혹은 내부적으로 사용하는 
가에 관계 없이 신호기의 개념이다. 그러므로 우선 신호기의 사용방법에 대한 설명으로 
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부터 시작하자. 

스레드의 동기화에 신호기를 리용하는 방법 


신호기 를 리 용하자면 그것 을 CreateSemaphare ( ) 를 사용하여 작성 하여 야 한다. 선 
언은 다음과 갈다. 


HANDLE CreateSemaphore(LPSECURITY_ATTRIBUTES IpSecA 竹 r, 
LONG InitialCount, 

LONG MaxCount, 

LPCSTR IpszName) : 


IpSecAttr 는 보안속성 에 대 한 지 시 자이 다. IpSecAttr 에 NULL 을 설정 하면 체 계 설 
정의 보안서술자가 사용된다. 

신호기는 한개이상의 과제에 객체에 대한 호출을 허가한다. 객체를 동시에 호출할수 
있는 과제의 수는 MaxCount 에 설정한다. MaxCount 의 값에 1 을 설정하면 신호기는 2 
값신호기와 갈은 기능을 가지게 되며 자원을 동시에 호출할수 있는 스레드 혹은 프로세 
스가 한개로 제한된다. 

신호기는 현재호출을 허가하고 있는 과제의 수를 관리하기 위한 계수기를 가지고 있 
다. 이 계수기의 값이 령이면 과제가 신호기를 해제할 때까지 다른 호출이 금지된다. 계 
수기의 값이 령보다 크면 신호기에 신호가 통지된 상태 이며 다른 스레드 에 호출이 허가 
된다. 스레드 에 호출이 허가될 때마다 계수기의 값이 감소된다. 

신호기의 계수기의 초기값은 InitialCount 에 설정한다. 계수기의 초기값이 령 이면 
어떤 프로그람이 신호기를 해제할 때까지 신호기를 가지 고 있는 모든 객체는 차단된다. 

일반적으로 계수기의 초기값에는 1 이상의 값을 설정하며 신호기가 적어도 한개이상 
의 과제를 허가하는 상태로 한다. 어떠한 경우에도 InitialCount 의 값은 령 이상이며 
MaxCount 에 설정된 값이 하여 야 한다. 

IpszName 에 는 신호기 객 체 의 이 름을 표시 하는 문자렬을 설정 한다. 신호기 는 몇 개의 
프로세스로부터 사용될수 있는 대역객체 이다. 두개의 프로세스가 각각 같은 이름으로 신 
호기 를 작성한 경 우에 는 두 프로세 스가 같은 신호기 를 참조하게 된다. 이 에 의 해 두 프 
로세스의 동기화가 달성된다. 

신호기의 이름을 NULL 로 할수도 있다. 이 경우에 신호기는 한 프로세스 내에서만 
사용되 게 된다. IpszName 에 기 존의 신호기 의 이 름을 설정 하는 경 우에 는 InitialCount 와 
MaxCount 의 값을 설정할 필요가 없다. 

CreateSemaphore ( 〉함수는 호출이 성 공한 경 우에 는 신호기 의 손잡이 를 돌려 주며 
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실 패 한 경 우 에 는 NULL 을 돌 려 준 다 . 작 성 한 신 호 기 를 사 용 하 려 면 
WaitForSingleObject () 및 ReleaseSemaphore ( )를 호출한다. 이 함수들의 선언은 다음 
과 갈다. 


DWORD WaitForSingleSemaphore (HANDLE hObject , 

DWORD dxHowLong ) : 

BOOL ReleaseSemaphore (HANDLE hSema , 

LONG Count , LPLONG IpPrevCount ); 

WaitForSingleSemaphore ( ) 는 신호기 (또는 어떤 동기화객체)를 기 다리는것 이 다. 

이 함수는 객체가 참조가능하게 되든가 림시중단 (time out ) 상태로 될 때까지 돌림값 
을 돌려 주지 않는다. 신호기를 사용하는 경우는 hObject 에 기존의 신호기의 손잡이를 
설정 한다. 

dwHowLong 파라메터 에는 ns 단위로 림시중단될 때까지의 대기시 간을 설정한다. 
이 시 간이 경 과하면 림 시 중단오유가 돌려 진다. 무한히 대 기하게 하려 면 중단시 간에 
INFINITE 를 설 정한다. 

이 함수는 호출이 성공하면 WAIT _ OBJECT _0 을 돌려 준다. (이것은 호출이 허가되 
였 다는것을 의미 한다.) 림시 중단된 경우는 WAIT_TIMEOUT 를 돌려 준 다. 
WaitForSingleSemaphore ( ) 의 호출이 성공한 경우에는 신호기의 계수기가 감소된다. 

ReleaseSemaphore ( ) 는 신호기를 해제하고 다른 스레드에 신호기의 사용을 허가한 
다. hSema 에 는 신호기 의 손잡이 를 설정 한다. Count 에 는 신호기 의 계 수기 에 더 할 값을 
설정 한다. 일반적 으로 이 값은 1로 된다. IpPrevCount 파라메터 에는 신호기의 계수기의 
직전값이 돌려 진다. 이 계수기의 값이 필요 없으면 IpPrevCount 에 NULL 을 설정한다. 
이 함수는 호출이 성공하면 령이 아닌 값을 돌려 주며 실패하면 령을 돌려 준다. 

실례 15-4 에 준 프로그람은 신호기의 사용방법을 보여 주기 위한것이다. 이 프로그 
탐은 이 장에서 처음 작성 한 다중스레 드프로그람을 개조하여 두개의 스레드를 동시 에 실 
행할수 없게 하였다. 다시말하여 두개의 스레드는 순차화되여 있다. 

신호기의 손잡이는 창문의 작성시에 설정되는 대역변수로 되여 있으므로 프로그람의 
모든 스레드(기본스레드를 포함)에서 참조할수 있게 되여 있는 점에 주의를 돌려야 한다. 
이 프로그람은 앞의 실례프로그람과 같은 머리부파일과 자원파일을 사용한다. 


실 례 15 - 4. Semaphore 프로그람 

// 신호기를 사용하는 다중스레드프로그람 

ttinclude 〈 windows. h> 

#include "thread, h” 
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#define MAX 5000 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
DWORD WINAPI MyThreadKLPVOID param); 

DWORD WINAPI MyThread2 (LPVOID param) ； 

char szWinName[] = ” My Win”; // 창문들라스의 이름 

char str[255]; // 표시할 문자렬을 보관한다 . 

DWORD Tidl, Tid2 ； // 스레드形 

HANDLE hSema ； // 신호기의 손잡이 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 


// 창문클라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) : 

wcl.hlnstance = hThisInst; // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ； // 큰 아이콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC.ARROW) ； // 유표의 형 식 

wcl. IpszMenuName = "ThreadMenu" ； // 기본차림 표 

wcl.cbClsExtra = 0; // 보조기억기령역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 
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// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) : 

// 창문콜라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문콜라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Use a Semaphore", // 제목 

WS_OVERLAPPEDWINDOW, II 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 믈라스차림 표의 덧쓰기는 하지 않는다 . 

hThisInst, // 실체의 손잡이 

NULL // 추가파라메 터 는 없 다 . 

)； 


// 건반가속기 를 적 재한다 . 

hAccel = LoadAccelerators (hThisInst, "ThreadMenu") : 


// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while(GetMessage(&msg , NULL, 0, 0)) 

{ 

if (! TranslateAccelerator (hwnd, hAccel, 技 msg)) { 
TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage(Smsg) ; // Windows 2000 에 조종을 넘 긴다 . 

} 
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return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

int response; 


switch (message) { 
case WM.CREATE ： 

hSema = CreateSemaphore(NULL, 1, 1, NULL); 
break ； 

case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM 一 THREAD: 

CreateThread(NULL, 0, (LPTHREAD_START_ROUTINE)MyThreadl, 
(LPVOID) hwnd, 0, &Tidl); 

CreateThread (NULL, 0, (LPTHREAD_START_ROUTINE)MyThread2, 
(LPVOID) hwnd, 0, 技 Tid2); 

break ； 


case IDM.EXIT ： 

response = MessageBox(hwnd, "Quit the Program?”, 
” Exit，，, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O); 
break ； 


case IDM_HELP: 

MessageBox (hwnd, 

” FI: Help\nF2 ： Demonstrate Threads”, 
"Help", MB_OK) ； 

break ； 

} 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 
PostQuitMessage (0) ； 
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break ； 
default : 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 계 )00 에 처 리를 맡긴다. */ 
return DefWindowProc(hwnd, message, wParam, IParam); 


return 0 ； 

} 

// 프로세스안에서 실행되는 스레드 

DWORD WINAPI MyThreadKLPVOID param) 

{ 

int i ； 

HDC hdc ； 

// 호출이 허가되기를 기다린다. 

if (WaitForSingleObject (h , 10000) ==WAIT_TIMEOUT) { 



MessageBox((HWND)param, "Time Out Thread 1", 


"Semaphore Error", MB_OK); 


return 0 ； 

} 

for(i=0 ； i<MAX ； i++) { 
if(i==MAX/2) { 

/* 처리가 절반 끝나면 신호기를 해제한다. 

이에 의해 Mythread2 의 실행이 가능하게 된다. */ 
ReleaseSemaphore (hSema, 1, NULL) : 

// 다시 호출이 허가되기를 기다린다. 

if (WaitForSingleObject (hSema, 10000) ==WAIT_TIMEOUT) { 
MessageBox((HWND)param, "Time Out Thread 1", 


'Semaphore Error", MB_OK); 


return 0 ； 
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wsprintf(str, ” Thread 1 ： loop # %5d ", i); 
hdc = GetDC ((HWND) param) ； 
TextOut(hdc, 1, 1, str, lstrlen(str)) ； 
ReleaseDC ((HWND) param, hdc) ； 

} 

ReleaseSemaphore (hSema, 1, NULL) ； 


return 0 ； 

} 

// 프로세스안에서 실행되는 다른 하나의 스레드 
DWORD WINAPI MyThread2 (LPVOID param) 

{ 

int i ； 

HDC hdc ； 

// 호출이 허가되기를 기다린다 . 

if (WaitForSingleObject (hSema, 10000) ==WAIT_TIMEOUT) { 
MessageBox((HWND) param, "Time Out Thread 2", 
’’Semaphore Error", MB_OK) ； 

return 0 ； 

} 

for(i=0 ； i<MAX ； i++) { 
wsprintf (str, "Thread 2 ： loop # %5d M , i) ； 
hdc = GetDC ((HWND) param) ； 

TextOut(hdc, 1, 20, str, lstrlen(str)) ； 

ReleaseDC((HWND) param, hdc); 

} 

ReleaseSemaphore (hSema, 1, NULL) ； 
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신호기프로그람의 상세 

이 프로그람에 서 는 두개 의 스레 드를 순차화하기 위하여 신호기 의 손잡이 가 hSema 
에 보관된다. 

실행 을 개 시하면 MyThread2( ) 보다 먼저 MyThreadK ) 이 능동상태 로 된다. 
MyThreadlC ) 이 작성 되 였 을 때 그것 이 곧 신호기 를 얻 고 실 행 을 개 시 하는것 이 다. 
MyThread2( ) 가 작성되였을 때는 신호기를 얻을수 없으며 대기상태로 된다. 

계속 대기상태로 있다가 MyThreadlC) 의 for 순환이 MAX/2 까지 실행되면 신호기 
가 해제되고 그로 인하여 MyThread2( ) 가 신호기를 받아서 실행을 개시한다. 이때는 
MyThreadK ) 이 대기상태로 된다. MyThread2( ) 의 실행이 끝나고 신호기가 해제되 
면 MyThreadK ) 의 실행이 재개된다. 

여기에 몇가지 시험해 보아야 할것들이 있다. 우선 신호기는 동시에 신호기를 호출 
할수 있는 스레드를 한 개만으로 제한하고 있 으므로 이것을 2 값신호기를 사용하는 방법 
으로 바꾸어보는것이다. 다음 hSema 에 설정하는 계수기의 값을 2나 3 으로 늘이고 스레 
드의 여러개의 실체를 실행할수 있게 하여 결과를 확인해 보는것이다. 

사건객체의 사용방법 


이미 설명한것처 럼 사건객체는 사건의 발생을 스레드나 프로세스에 통지 하는데 사용 
된다. 사건객 체 를 작성 하기 위 하여 CreateEvent () 타는 API 함수를 사용한다. 선언은 다 
음과 갈다. 


HANDLE CreateEvent(LPSECURITY_ATTRIBUTES IpSecAttr, 

BOOL Manual, 

BOOL Initial, 

LPCSTR IpszName) : 

IpSecAttr 에 는 보안속성 혹은 NULL 을 설정 한다. NULL 을 설정 한 경 우는 체 계설 
정의 보안서술자가 사용된다. Manual 은 사건이 발생 했을 때의 사건객체의 동작을 결정 
한다. 

Manual 의 값이 령 이 아닌 경 우 사건 객 체 는 ResetEvent () 함수를 호출했 을 때 만 
재설정되게 된다. 이 값이 령인 경우 사건객체는 차단된 스레드에 호출이 허가되였을 때 
자동적으로 재설정된다. 

Ini 吐신에는 객체의 초기상태를 설정한다. Initial 의 값이 령이 아닌 경우 사건객체가 
설정상태 (사건이 통지된 상태)로 된다. 령 인 경우는 사건이 재설정된 상태 (사건이 통지 
되지 않은 상태)로 된다. 

IpszName 에는 사건객체의 이름을 표시하는 문자렬을 설정한다. 사건객체는 여러개 


580 


교육성 프로그람교육쎈터 




제 15 장. 스레드에 기초한 다중과제처리 


의 프로세스에서 사용되는 대역객체이다. 두개의 프로세스가 같은 이름으로 사건객체를 
열기한 경우에는 두 프로세스가 동일한 객체를 참조한다. 이에 의해 두 프로세스가 순차 
화된다. IpszName 에 NULL 을 설정한 경우 객체는 한 프로세스안에서만 사용되게 된다. 

CreateObject ( ) 는 호출이 성 공하면 사건객체의 손잡이 를 돌려 주고 실패 하면 
NULL 을 돌려 준다. 

사건객 체 가 작성 되 면 사건의 발생 을 기 다리 는 스레 드(또는 프로세 스)는 첫 파라메터 
에 사건객 체 의 손잡이 를 주어 WaitForSingleObject ( ) 를 호출한다. 이 에 의 해 스레 드 
또는 프로세스의 실행은 사건이 발생할 때까지 정지된다. 

사건의 발생 을 통지 하는데는 SeffiyenfO 함수를 사용한다. 선언은 다음과 같다. 


BOOL SetEvent (HANDLE hEventObject) : 

hEventObject 에는 기존의 사건객체의 손잡이를 설정한다. 이 함수가 호출되면 사 
건의 발생을 대기하고 있는 첫 스례드 또는 프로세스의 WaitForSingleObject( ) 가 돌림 
값을 돌려 주므로 실행을 재개할수 있다. 

사건객체의 기능을 시험해 보기 위해 앞에서 작성한 프로그람을 다음과 같이 개조해 
보자. 우선 hEvent 라는 이름의 대 역 변수를 선언한다. 다음 WM_CREATE 의 case 문에 
다음의 행을 추가한다. 

hEvent = CreateEvent(NULL, FALSE, FALSE, NULL); 

마지막으로 MyThreadlC ) 과 MyThread2( )를 다음과 같이 변경한다. 

// 첫번째 스레드 

DWORD WINAPI MyThreadKLPVOID param) 

{ 

int i ； 

HDC hdc ； 

// 호출이 허가되기를 기 다린다 . 

if (WaitForSingleObject (hSema, 10000) ==WAIT_TIMEOUT) { 

MessageBox((HWND)param, "Time Out Thread 1", 

"Event Error", MB_OK); 

return 0 ； 

} 

for(i=0 ； i<MAX ； i++) { 
wsprintf (str, “Thread 1 ： loop # %5d “, i); 
hdc = GetDC((HWND) param); 
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TextOut(hdc, 1, 1, str, ktrlen(str)) ; 
ReleaseDC ((HWND) param, hdc) ； 

} 


return 0 ； 

} 

// 두번째 스레드 

DWORD WINAPI MyThread2(LPVOID param) 

{ 

int i; 

HDC hdc ； 

for(i=0 ； i<MAX ； i++) { 
wsprintf(str, "Thread 2: loop # %5d ", i); 
hdc = GetDCC(HWND) param); 
TextOut(hdc, 1, 20, str, lstrlen(str)) ； 
ReleaseDC ((HWND) param, hdc )； 

} 

// 사건을 통지 한다 . 

SetEvent (hEvent); 


return 0 ； 

} 

프로그람을 실행하면 MyThread 2( ) 의 실행이 끝났다는것이 통지될 때까지 
MyThreadl ( ) 의 실행 이 차단된 다 . 

기다림시계의 사용방법 


일반적인 시계는 모든 Windows 판본에서 제공되지만 기다림시계는 최근에 와서 추 
가되였다. 표준시계를 신호기와 함께 사용할수도 있지만 기다림시계를 사용하는 편이 더 
편리 하다. 

기다림시계는 놀라운 능력을 가지고 있다. 왜냐하면 과제를 배경으로 실행하는 기능 
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을 간단히 실현할수 있기때문이다. 

이식과 관련한 요점 : 기 다림시계는 Windows NT 4. 0 에서부터 추가된것 이며 Windows 
NT 3. 51 ， Windows 95 및 Windows 3. 1 에서는 지원되지 못하였다. 그러나 Windows 98 
에서는 지원였다. 


기다림시계는 설정된 시간까지 배경으로 실행되는 시계이다. 스레드는 사건객체의 
경우와 같이 Wai 1: ForSingleObject () 함수를 사용하여 시계의 통지를 대기할수 있다. 스 
레드는 시계에 설정된 시간이 경과할 때까지 차단된다. 

기 다림 시 계 를 작성 하자면 CreateWaitableThner ( ) 항수를 사용하여 야 한다. 선 언은 
다음과 갈다. 


HANDLE CreateWaitableTimer ( LPSECURITY_ATTRIBUTES 
IpSecAttr , BOOL manual , 
LPCSTR IpszName ) : 


IpSecAttr 에는 기 다림시 계의 보안서술자의 지시 자를 설정한다. 이 파라메터 에 
NULL 을 설정 하면 체계 설정의 보 안서 술자가 사용된 다 . 

manual 에 령이 아닌 값을 설정한 경우 시간이 경과한후에 시계를 수동적으로 재설 
정하여야 한다. 이 값에 령을 설정한 경우는 시계가 자동적으로 재설정된다. 

IpszName 에는 시계의 이름을 설정한다. 시계에 이름을 붙이지 않은 경우는 이 파 
라메 터 에 NULL 을 설정한다. 이름을 달아 준 시계는 여 러 개의 프로세스에서 공유될수 
있게 된다. 이름을 붙이지 않은 시계는 그것을 작성한 프로세스내 에서만 사용된다. 이 
함수는 호출이 성공하면 기 다림시계의 손잡이를 돌려 주며 호출이 실패하면 NULL 을 
돌려 준다. 

시 계가 작성된 직후 시계는 능동상태로 되여 있지 않다. 시계를 설정하려면 
SetmiitableTimer ( ) 을 호출하여 야 한다. 선언은 다음과 같다. 


BOOL SetWaitableTimer (HANDLE hWaitTimer , 

const LARGE_INTEGER * TargetTime , 

LONG period , 

PTIMERAPCROUTINE lpTimerFunc , 

LPVOID par am , 

BOOL Unsuspend ); 

hWaitTimer 에 는 시 계 객 체 의 손잡이 를 설정 한다. TargetTime 에 는 시계의 완료시 간 
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을 설정 한다. period 에는 시계 가 통지 를 진행 하는 시 간간격 을 ms 단위 로 설정 한다. 
period 에 령 을 설정 하면 시 계 로부터 의 통지 는 한번만으로 된 다. 

lpTimerFunc 에는 시계 가 통지를 진행할 때 호출되는 함수(시계 함수)의 지시 자를 
설정한다. 이 함수는 추가선택 항목이 다. 시 계함수가 펼요 없으면 lpTimerFunc 에 
NULL 을 설 정한다. 

param 에는 시 계 함수에 전달하는 파라메 터 를 설정 한다. Unsuspend 의 값이 령 아닌 
경우는 전력절약방식으로 동작하고 있는 틈퓨터가 재개된다. SetWaitableTimer ( ) 는 호 
출이 성공하면 령 이 아닌 값을 돌려 주며 호출이 실패하면 령을 돌려 준다. 
lpTimerFunc 에 지 적 하는 시 계 함수의 선언은 다음과 같이 하여 야 한다. 


VOID CALLBACK TimerFunc(LPVOID param , 

DWORD dwLowTime , 

DWORD dwHightTime ) : 

param 에는 SetWaitableTimer ( )로부터 전달된 값이 보관된다. dwLowTime 과 
dwHightTime 에는 用 L 표 77 ME 1 구조체와 호환성 있는 형 식으로 완료시 간이 보관된 
다. (시간의 형식에 대해서는 뒤에서 본다.) 일반적으로 기다림시계를 사용하는 대부분의 
응용프로그람에서 는 시 계함수를 필요로 하지 않는다. 

SetWaitableTimer ( ) 를 호출할 때 는 목적 하는 시 간을 八^£往£7? 공용체 에 

설정 한다. 이 공용체는 穴 ZL 표 rZME 구조체 에서 정의되 여 있는것과 호환성 이 있는 64 bit 
옹근수이며 시 간을 표시한다. 량자의 정의를 아래 에 보여 주었다. 

typedef struct _FILETIME { 

DWORD dwLowDateTime ； // 아래자러 32bit 
DWORD dwHightDateTime ； // 웃자리 32bit 

} FILETIME ； 


typedef union _LARGE_INTEGER { 
struct { 

DWORD LowPart ； 

LONG HighPart ； 

} 

LONGLONG QuadPart ； 

} LARGEJNTEGER ； 


FILETIME 구조체 에는 16()1 년 1 월 1일부터 경과한 시 간이 100 ns 의 단위 로 보관된다. 
Win 32 는 FILETIME 구조체에 보관된 시간을 다른 시간형식으로 변환하는 함수를 
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여러개 제공하고 있다. 기다림시계에서 목적하는 시간을 설정하기 위한 가장 간단한 방 
법은 우선 SYSTEMTIME 구조체를 사용하여 시간을 설정한 다음 그것을 FILETIME 구 
조체 로 변환하는것 이 다. (이 렇게 하여 LARGE_INTEGER 공용체 로 변환할수 있 다. ) 제 
14 장에 서 본것 처 럼 SYSTEMTIME 구조체 는 다음과 같이 정 의 되 여 있 다. 

typedef struct _SYSTEMTIME { 


WORD wYear ； 

// 

년 

WORD wMonth ； 

// 

월 (1~12) 

WORD wDayOfWeek ； 

// 

요일 (0~6) 

WORD Day ； 

// 

일 (1 〜 31) 

WORD wHour 

// 

시 

WORd wMinute 

// 

분 

WORD wSecond 

// 

초 

WORD wMilliseconds ； 

// 

미리초 


} SYSTEMTIME ； 


목적 하는 시 간을 설 정 하려 면 SYSTEMTIME 구조체 의 성 원들을 초기 화하고 다음 
SystemTimeToFileTime ( ) 을 호출하여 그 시간을 FILETIME 구조체로 변환한다. 
SystemTimeToFileTime ( ) 의 선언은 다음과 같다. 


BOOL SystemTimeToFileTime (CONST SYSTEMTIME * lpSysTime , 

FILETIME * l P FileTime ) : 

이 함수는 호출이 성 공하면 령 이 아닌 값을 돌려 주며 호출이 실패하면 령 을 돌려 
준다. 

기다림시계를 사용하는 대부분의 경우에 SYSTEMTIME 구조체의 모든 성원을 수동 
적 으로 설정할 필요는 없다. 보통 현재체 계시각을 얻 고 그것 에 목적하는 시 간을 더하면 
된다. 실례로 1 시간의 시계를 작성하려면 현재체계시각을 얻고 그의 wHour 성원에 적 
절한 값을 더하면 될것이다. 현재체계시각을 얻자면 GetSystemTime () 을 사용해야 한다. 
선언은 다음과 갈다. 


VOID GetSystemTime (SYSTEMTIME * lpSysTime ) ; 


현재의 체계시각은 IpSysTime 이 가리키는 구조체에 돌려 진다. 체계시각은 협정세 
계 시 (UT 必로 표시된다. 이것은 기 본적 으로 그리 니 치 표준시 ( GMT ) 와 같다. 

실례 15-5 의 프로그람은 기 다림시 계의 사용방법 을 보여 주는 프로그람이다. [F 幻건 
을 누르면 스레드가 작성된다. 이 스례 드에서 기 다림시계 가 작성 되 고 목적하는 시 간이 
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10 ms 단위로 설정된다. 창문이 최소화되고 스레드가 시계의 시간경과를 기다린다. 시계 
의 설정시간이 경과하면 창문이 본래의 크기로 복귀되며 스레드의 실행이 재개된다. 

_WIN32_，mNNT 정 악를 프로그람의 선두에 기입한 점에 주의를 돌려 야 한다. 기다 
림시계는 최근에 추가된것이므로 적절한 머리부파일의 정보를 인용하자면 이 정의가 필 
요하게 되는 번역프로그람들도 있다. 


실 례 15-5. WaitableTimer 프로그람 
// 기다림시계의 실례 

/* 아래의 정의는 기다림시계의 API 를 
사용하기 위해 필요한것이다 . */ 
ttdefine _WIN32_WINNT 0x0400 

ttinclude 〈 windows. h> 
include "thread. h n 

#define MAX 10000 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
DWORD WINAPI MyThreadl (LPVOID param) ； 

char szWinName[] = ” My Win"; // 창문들라스의 이름 

char str[255 ]； // 표시 할 문자렬을 보관한다 . 

DWORD Tidl ； // 스레드 ID 

HANDLE hWaitTimer ； // 신호기의 손잡이 

int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 


586 


교육성 프로그람교육쎈터 




제 15 장. 스레드에 기초한 다중과제처리 


// 창문콜라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ; 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계 설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이론 
wcl. hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl. IpszMenuName = "WaitTimerMenu" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 


// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


A 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow( 
szWinName, // 창문믈라스의 이름 
"Use a Waitable Timer", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자리 표는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 높이 는 Windows 가 결 정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 물라스차림표의 덧쓰기는 하지 않는다 . 

hThisInst, // 실체의 손잡이 

NULL // 추가파라메터는 없 다 . 
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)； 


// 건반가속기를 적재 한다 . 

hAccel = LoadAccelerators (hThisInst, "WaitTimerMenu") : 

// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while(GetMessage(&msg , NULL, 0, 0)) 

{ 

if(! TranslateAccelerator(hwnd, hAccel, 技 msg)) { 
TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage(Smsg) ; // Windows 2000 에 조종을 넘 긴다 . 

} 

} 

return msg. wParam ； 

} 


/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

int response ； 


switch (message) { 
case WM_CREATE ： 

// 시계를 작성한다 . 

hWaitTimer = CreateWaitableTimer(NULL, 1, NULL); 
break ； 

case WM_COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM_THREAD: 

CreateThread(NULL, 0, (LPTHREAD_START_ROUTINE)MyThreadl, 


588 


교육성 프로그람교육쎈터 



제 15 장. 스레드에 기초한 다중과제처리 


(LPVOID) hwnd, 0, &Tidl) ； 

break ； 

case IDM—EXIT: 

response = MessageBox (hwnd, "Quit the Program? M , 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQu 仕 Message (0); 
break ； 

case IDM_HELP: 

MessageBox (hwnd, 

” FI: Help\nF2: Demonstrate Timer", 

” Help", MB_OK) ； 

break ； 

} 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0); 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처리를 맡긴다 . */ 
return DefWindowProc (hwnd, message, wParam, IParam) ； 

} 


return 0 ； 


// 기다림시계의 실례 

DWORD WINAPI MyThreadl (LPVOID param) 

{ 

int i ； 

HDC hdc ； 

SYSTEMTIME systime ； 

FILETIME filetime ； 

LARGE_INTEGER li ； 


// 현재의 체계시각에 10s 를 더한다 . 
GetSystemTime (&systime) ； 
SystemTimeToFileTime (&systime, &filetime) ； 
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li. LowPart = filetime. dwLowDateTime ； 
li.HighPart = filetime. dwHighDateTime ； 
li.QuadPart += 100000000L ； 

// 시계를 설정한다 . 

SetWaitableTimer (hWaitTimer ， &li, 

0, NULL, NULL, 0); 

// 시계가 기동될 때까지 창문을 최소화해 둔다 . 

ShowWindow ((HWND) param, SW_MINIMIZE) : 

// 시계의 기동을 대기한다 . 

if (WaitForSingleObject (hWaitTimer, 100000) ==WAIT_TIMEOUT) { 

MessageBox((HWND)param, "Time Out Thread 1", 

"Timer Error", MB_OK); 

return 0 ； 

} 

// 경보음을 울리고 창문을 본래의 크기로 복귀한다 . 

MessageBeep (MB_OK) : 

ShowWindow((HWND) param, SW_RESTORE); 

hdc = GetDC((HWND) param) ； 
for(i=0 ； i<MAX ； i++) { 
wsprintf(str, "Thread 1 ： loop # %5d ", i); 

TextOut(hdc, 1, 1, str, lstrlen(str)) ； 

} 

ReleaseDC((HWND) param, hdc); 
return 0 ； 

} 

이 프로그람은 앞의 실례프로그람과 같이 THREAD.H 라는 머리부파일을 사용한다. 
그러나 이 프로그람이 사용하는 자원파일은 다음과 같다. 

#include 〈 windows. h> 

♦include "thread, h" 

WaitTimerMenu MENU 

{ 

POPUP ’^Options” { 
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MENUITEM "SWaitable Timer \tF2", IDM_THREAD 
MENUITEM "E&xit\tCtrl+X", IDM_EXIT 

} 

MENUITEM "&Help", IDM_HELP 


WaitTimerMenu ACCELERATORS 
{ 

VK_F1, IDM_HELP, VIRTKEY 
VK_F2, IDM_THREAD, VIRTKEY 
"~X", IDM_EXIT 

} 

기다림시계의 활용방법 

기다림시계에는 여러가지 활용방법이 있다. 경종시계를 콤퓨터로 실현하는데 기다림 
시계를 사용한다. 그러자면 사용자가 목적하는 경종시각을 설정하기 위한 대화칸을 작성 
하고 설정된 값을 기다림시계를 초기화하는데 사용하면 편러할것이다. 

기다림시계를 사용하여 자동적인 예비복사 ( Backup ) 나 파일전송 전용프로그람을 작 
성할수도 있다. 이러한 종류의 시계는 다른 동기화객체와 일반적인 시계를 결합하여 작 
성할수도 있지만 기 다림시계를 러용하여 작성하는 방법 이 보다 간단한것 이 다. 

다른 프로그람몰 기동하는 방법 


Windows 2000 의 스레드에 기초한 다중과제처리기능은 프로그람작성기술의 양상에 
커다란 충격을 주었다. 이밖에도 프로세스에 기초한 다중과제처리기능에는 여러가지 활 
용방법이 있다. 프로세스에 기초한 다중과제처리기능을 사용할 때는 갈은 프로그람내에 
서 다른 스레드를 기동하는것이 아니라 한 프로그람이 다른 프로그람을 기동하는것으로 
된다. Windows 2000 에서는 이것을 CreateProcessC ) 라는 API 함수를 사용하여 실현할 
수 있다. 선언은 다음과 갈다. 


BOOL CreateProcess (LPCSTR IpszName , LPSTR lpszComLine , 
LPSECURITY_ATTRIBUTES IpProcAttr , 
LPSECURITY_ATTRIBUTES lpThreadAttr , 
BOOL InheritAttr , DWORD How , 

LPVOID IpEnv , LPCSTR IpszDir , 
LPSTARTUPINFO lpStartlnfo , 
LPPROCESS_INFORMATION IpPInfo ); 
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실행할 프로그람의 이름은 IpszName 이 가리키는 문자렬에 완전경 로로 설정한다. 
프로그람에 필 요되 는 지 령 행 파라메 터 는 IpszComLine 이 가리 키 는 문자렬 에 설 정 한다. 
그러 나 IpszName 에 NULL 을 설정 하면 IpszComLine 에 설정된 문자렬의 첫 토막이 프 
로그람의 이름으로서 사용된다. 일반적으로는 IpszName 에 NULL 을 설정 하고 프로그람 
의 이 름과 필요한 파라메 터 를 IpszComLine 에 설정 한다. (만일 Winl 6 의 프로세 스를 기 
동하면 IpszName 에 NULL 을 설정하여 야 한다. ) 

IpProcAttr 및 lpThreadAttr 에 는 작성되는 프로세 스의 보안속성 을 설정 한다. 이것 
들에 NULL 을 설정한 경우는 체계설정의 보안서술자가 사용된다. InheritAttr 에 령 이 
아닌 값을 설정한 경우는 프로세스의 작성에 사용된 손잡이가 새로운 프로세스에 계승된 
다. 이 파라메터 에 령 을 설정 한 경우는 손잡이 가 계승되지 않는다. 

체계설정으로 새로운 프로세스는 표준적으로 실행된다. How 파라메 터를 사용하면 
프로세스의 작성방법에 영향을 주는 몇가지 속성을 설정 할수 있다. (실례로 How 를 사용 
하여 프로세 스에 특수한 우선권순위 를 설정하거 나 프로세 스가 오유수정방식 으로 동작한 
다는것을 지시할수도 있다.) How 에 령을 설정 한 경우에 새로운 프로세스는 표준적 인 
프로세스로서 작성된다. 

IpEnv 에 는 새 로운 프로세 스의 환경 파라메 터 를 보관한 완충기 를 설정 한다. IpEnv 에 
NULL 을 설정한 경 우 새 로운 프로세 스는 그것 을 작성 한 프로세 스의 환경 을 계 승한다. 

새 로운 프로세 스의 현재 구동기 (current drive ) 와 현재 등록부 (current directory ) 를 
IpszDir 가 가리 키 는 문자렬 에 설정 한다. 이 파라메 터 에 NULL 을 설정 하면 프로세 스를 
작성 한 프로세 스의 현재 구동기 와 현재 등록부가 사용된 다. 

lpStartlnfo 에 는 새 로운 프로세 스의 기 본창문의 표시 방법 을 가리 키 는 STARTUPINFO 
구조체의 지시자를 설정한다. STARTUPINFO 구조체의 정의는 다음과 같다. 


typedef struct .STARTUPINFO { 


DWORD cb ； 


// STARTUPINFO 의 크기 


LPSTR IpReserved ； 
LPSTR lpDesktop ； 
LPSTR lpTitle ； 
DWORD dwX ； 
DWORD dwY ； 
DWORD dwXSize ； 
DWORD dwYSize ； 


// NULL 을 설정해야 한다 . 

// 탁상면의 이름 

" 조종탁의 이름 ( 조종탁프로그람에서만 ) 
// 창문의 왼쪽 웃모서 리 의 X 자리 표 
// 창문의 왼쪽 웃모저 러 의 Y 자러표 
// 창문의 너비 
// 창문의 높이 


DWORD dwXCountChars ； // 조종탁의 너비 


DWORD dwYCountChars ； // 조종탁의 높이 
DWORD dwFillAttribute ； // 본문과 배경의 색 


DWORD dwFlags ； // 어느 성원이 유효한가를 보여 주는 기발 

WORD wShowWindow ； // 창문의 표시 방법 (SW_SHOW 등 ) 

WORD cbReserved2 ； // 0 을 설정 해 야 한다 . 
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LBYTE lpReserved2 ； // NULL 을 설정해야 한다 . 

HANDLE hStdlnput ； // 이하는 표준손잡이 
HANDLE hStdOutput ； 

HANDLE hStdError ； 

} STARTUPINFO ； 

dwX , dwY , dwXSize , dwYSize , dwXCountChars , d w Y CountChar s , 
dwFillAttribute , wShowWindow , hStdlnput , hStdOutput 및 hStdError 의 각 성 원 
은 dwFlags 성원에 설정된 값에 따라서 무시되거나 유효하게 된다. dwFlags 에 설정할 
수 있는 값은 다음과 갈다. 


STARTF—USESHOWWINDOW 

dwShowWindow 

STARTF—USESIZE 

dwXSize , dwSize 

STARTF USEPOSITION 

dwX , dwY 

STARTF_USECOUNTCHARS 

dwXCountChars , dw Y CountChar s 

STARTF USEFILLATTRIBUTE 

dwFillAttribute 

STARTF_USESTDHANDLES 

hStdlnput , hStdOutput , hStdError 

STARTF—USEFORCEONFEEDBACK 

유표를 표시한다. 

STARTF—USEFORCEOFFFEEDBACK 

유표를 표시 하지 않는다. 


dwFlags 에 는 이 값들을 한개 이 상 조합하여 설정할수 있 다. 

참고 : lpTitle , dwXCountChars , dwYCountChars 및 dwFill Attribute 의 각 성원은 
조종탁응용프로그람에 만 적용된다. 

일 반적 으로 STARTUPINFO 의 성 원의 대 다수는 설정할 필요가 없으므로 그것 들을 
무시 하도록 dwFlag 를 설정 한다. 그러 나 구조체의 크기를 표시 하는 cb 는 반드시 설정 
하고 기 타 몇개의 성원에는 NULL 을 설정해 야 한다는 점 에 주의해 야 한다. 

CreateProcessC ) 의 마지 막 파라메 터 인 IpPInfo 에 는 PROCESS-INFORMATION 구 
조제와 지시 자를 설정한다. 이 구조체 의 정의는 다음과 같다. 

typedef struct _PROCESS_INFORMATION { 

HANDLE hProcess ； // 새로운 프로세스의 손잡이 

HANDLE hThread ； // 기본스레드의 손잡이 
DWORD dwProcessId ； // 새로운 프로세스의 ID 
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DWORD dwThread ； II 새로운 스레드의 ID 
} PROCESS-INFORMATION; 

새로운 프로세스 및 그 프로세스의 기본스레드손잡이 가 hProcess 및 hThread 에 
돌려 진다. 새 로운 프로세스 및 새로운 스레드의 ID 가 dwProcessId 및 dwThreadld 
에 돌려 진다. 프로그람에서 이 정보를 사용하건 무시하건 관계 없다. 

CreateProcess ( ) 는 호출이 성공하면 령이 아닌 값을 돌려 주며 실패하면 령을 돌 
려 준다. 아래의 프로그람코드는 CreateProcess ( ) 의 사용방법을 보여 주었다. 

STARTUPINFO startinfo ； 

PROCESS.INFORMATION pinfo ； 

//... 

startinfo. cb = sizeof (STARTUPINFO) ； 
startinfo. IpReserved = NULL ； 
startinfo. lpDesktop = NULL ； 
startinfo. lpTitle = NULL ； 

startinfo. dwFlags = STARTF.USESHO WWINDO W ； 
startinfo. cbReserved2 = 0 ； 
startinfo. lpReserved2 = NULL ； 
startinfo. wShowWindow = SW_SHOW ； 

CreateProcess(NULL, “test.exe ”， 

NULL, NULL, 0, 0, 

NULL, NULL, &startinfo, &pinfo) ； 

여기에서는 어미프로세스의 현재등록부에 보관되여 있는 TEST.EXE 라는 이름의 
프로그람을 기동하고 있다. 기동된 프로그람은 초기에 표시상태로 된다. 

작성된 새로운 프로세스(새끼프로세스)는 그것을 작성한 어미프로세스와 거의 독립 
적 인것으로 된다. 그러나 어미 프로세스가 새끼프로세 스를 완료시 킬수 있다. 그렇게 하자 
면 TerminateProcess ( 상라는 API 함수를 사용해 야 한다. 

이식과 관련한 요점 : Windows 3.1 에서 는 CreateProcess ( ) 가 지 원되지 않는 다. 
Windows 3. 1 에서 다른 프로세스를 기동하려면 WinExec ( ) 함수를 사용한다. 그러나 
WinExec ( ) 은 낡은 형식의것이므로 Win 32 프로그 람에서는 사용하지 말아야 한다. 그러 
므로 낡은 프로그람을 이식할 때는 WlnExecC ) 을 사용하는 부분을 CreateProcessC ) 로 
치환하여야 한다. 
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두 종류의 도움말체계 


Windows 2000 은 직 결도움말 (Online Help) 을 폭넓 게 지 원한다. 일 반적 
으로 모든 프로그람은 여러가지 기능에 대한 조작설명을 직결로 사용자에게 
제 공한다. 도움말체 계 (Help system) 를 사용하여 직 결문서 를 제 공하는 응용 
프로그람들도 많다. 직결도움말을 제공하지 않는 응용프로그람은 본격적인 
Windows 2000 응용프로그람이 라고 말할수 없다. 

이 장에서는 직결도움말의 작성 방법과 그것을 리용하기 위한 프로그람 
작성기술에 대하여 설명한다. 



Windows 2000 프로그람작성법 


도움말의 두 종류 


Windows 2000 은 두가지 종류의 도음말을 지 원하고 있다. 첫번째 도움말은 수년간 
Win 32 프로그람에서 사용되여 온 고전적인 수법을 리용하는것이다. 이 수법에서는 
WinHelp ( ) 라는 API 함수를 리 용하여 일 반적 인 창문에 도움말정 보를 표시한다. 이 수 
법 은 일 반적 으로 WinHelp 도움말이라고 부론다. 

두번째 도움말은 HTML 도움말이라고 하며 HtmlHelp ( ) 라는 API 함수를 사용하는 
수법 이 다. HTML 이 란 HyperText Markup Language 의 줄임 말이 며 HTML 도음말아 사 
는 열 람기 ( Browser ) 형 식 으로 도움말정 보를 표시 한다. 

이 장에서는 WinHelp 도움말파 HTML 도 S 말퐈 두가지 체계에 대해 설명 한다. 
HTML 도움말방식 은 새 로운 방식 으로서 Windows 2000 에서 받아 들인것 이 다. 고전적 인 
수법도 현존하는 많은 응용프로그람들에서 사용되고 있으며 많은 새로운 개발계획들에도 
여전히 받아 들이고 있다. 그러므로 모든 프로그람작성자들은 우선 WinHelp 도움말에 
대해 알아 둘 필요가 있다. 

이 고전적 인 도움말체계는 32 bit 의 모든 판본의 Windows 에서 동작한다. 이에 비 
하여 HTML 도움말이 동작하자면 반드시 Internet Explorer (3 .x 이 후)의 부분품 
( Component ) 이 설치되 여 있어 야 한다. Windows 2000 은 이 조건을 완전히 만족시키 고 
있지만 Windows 95 등의 대다수 체계는 만족시키지 못하고 있다. 

그러므로 이식성 이 있는 도움말체계를 작성하자면 고전적 인 수법을 사용해야 한다. 
두 종류의 도움말체계 는 내부적 으로는 대체 로 동일하며 도움말프로젝 트의 작성 방법 에 
차이가 있을뿐이다. 


상황의존도움 말과 참조도움 말 


Windows 가 지원하는 도움말은 두가지 부류로 구분할수 있다. 첫번째 부류는 직결 
문서 인데 이것을 효조도움말이라고 부론다. 

참조도움말은 그림 16-1 과 같은 도움말창문에 표시된것 이다. 이 창문을 사용하여 여 
러 가지 도움말표제 ( Topic ) 들을 표시 하거 나 다른 표계 을 검 색 하거 나 도움말파일의 차례 
를 표시할수 있 다. 참조도움말은 응용프로그람이 지 원하는 여 러 가지 기 능에 대 한 조작설 
명 을 표시하거 나 응용프로그람의 직 결 사용자지 도서 로서 리 용된 다. 
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L) 

그림 i 6- t . Ee 말창문 

-I - 고전적인 도음말창문 , L - HTML 도용말의 창문 

도움말의 두번째 부류는 상황의존도음말이 다. 상 m 의존도움말은 작은 창문안에 프로그 
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람의 부분적기능에 대한 짧은 설명을 표시하는데 쓰인다. 그림 16-2 에 그 실례를 보여 주 
었다. 본격적 인 Windows 2000 응용프로그람으로 되 자면 두 부류의 도움말기능을 갖추어 
야 한다. 겉보기에는 차이가 있지만 두가지 부류의 도움말은 대체로 동일한 방법으로 취 
급된다는것을 점차 알게 될것이다. 



그림 16 - 2 . 상황의존도 g 말의 실 ■ 


사용자가 도움말들 기동하는 네가지 방법 


본격적인 Windows 응용프로그람을 작성하자면 사용자가 여러가지 방법으로 직결도 
움말을 기동할수 있어 야 한다. 일반적으로 사용자는 아래의 네가지 방법으로 도움말을 
기동한다. 


• 객체우에서 마우스의 오른쪽 단추를 누른다. 

• [ f ] 단추를 누른 다음 객체를 찰칵한다. 

• [ F 1] 건을 누른다. 

• [ Help ] 차림표를 리용한다. 

첫 두가지 방법 에 의하면 상황의 존도움말이 기 동된 다. 많은 경 우 [ F 1] 건도 상황의 
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존도움말을 기동하는데 사용되지만 참조도움말이 기동되는 경우도 있다. [ Help ] 차림표 
를 사용하면 참조도움말이 기동된다. 

임의의 시점에서 응용프로그람으로부터 도움말을 기동할수도 있다. 례하면 사용자가 
무효한 조작을 진행한 경우에 응용프로그람이 도움말을 기동하는것과 갈은 경우이다. 

사용자가 도움말을 요구했을 때 응용프로그람은 사용하고 있는 도움말체계의 종류에 
따라 WinHelp () 또는 HtmlHlepC ) 의 어느 하나를 호출하여 응답한다. 


WinHelp 에 의한 도움말체계의 리용방법 


이 절에서는 WinHelp () 를 사용하는 고전적인 도움말체계를 설명한다. 이미 설명한 
바와 같이 WinHelp ( ) 는 고전적 인(구식의) 도움말창문을 표시한다. 열 람기형식의 도움 
말체계가 필요하지 않거나 혹은 리용할수 없는 환경에서 고전적인 도움말체계를 리용하 
여 야 한다. 

WinHelp 의 도움말과일 

Windows 의 고전적 인 도움말체계의 핵심으로 되는것은 도 S 말파일아 다. 상황의존도 
움말과 참조도움말은 다 도움말파일을 리 용한다. WinHelp 의 도움말파일은 본문파일 이 
아니 다. 번역되 여 있으며 .HLP 라는 확장자를 가지 는 특수한 파일 이다. 도움말파일을 
작성하기 위해서는 먼저 RTF (Rich Text Format ) 파일을 작성 하여야 한다. RTF 파일 0 :}: 
에는 모든 도움말항목외에 양식정보，색 인정보，교차참조정보 등이 보관된다. RTF 파일 
의 확장자는 일반적으로 . RTF 파일로 한다. RTF 파일은 도움말번역프로그람으로 번역한 
다. 

WinHelp 의 도움말파일을 번역할 때는 Microsoft Help Workshop (프로그람파일의 
이 름은 HCW . EXE ) 를 리 용한다. HCW.EXE 의 출력 이 HLP 파일 로 된 다. 다시 말하여 
도움말번역 프로그람의 위 치 에서 보면 RTF 파일 이 원천파일 이고 HLP 과일 이 객 체 파일로 
되게 된다. 

RTF 파일을 서술하는 RTF 언어에는 수많은 지령들이 있다. 도움말번역프로그람은 
이러한 지령들중의 일부에 대해서만 대응하고 있다. 또한 도움말체계에서는 일반적인 
RTF 언어에 포함되여 있지 않는 특수한 지령도 몇가지 쓰인다. 모든 RTF 지령은 선두 
에 \표식 이 불어 있다. 실례로 \b 라는 RTF 지 령은 굵은체 ( bold ) 를 의미한다. 

이 장에서 모든 RTF 지령을 설명하는것은 불가능하다. 그래서 이 장에서는 도움말파 
일을 작성하는데서 가장 중요하게 쓰이는 지 령들만을 설명 한다. 만일 앞으로 WinHelp 의 
도움말파일을 본격적으로 사용하려 한다면 RTF 지령을 전부 정통해야 한다. 

도움말번역 프로 그람에 는 RTF 파일 뿐아니라 프로젝트 파일도 필요 하다. 이 파일은 
HCW 도움말번역 프로 그람에 의해 작성된다. WinHelp 의 프로젝트 파일의 확장자는 .HPJ 
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이 다. 

도움말파일의 작성 

앞에서 설명한것처럼 WinHelp 의 도움말파일의 원천코드는 RTF 형식 이여야 한다. 
그러므로 도움말파일의 원천파일을 작성하는것은 결코 쉽지 않다. 

도움말파일을 작성하는 방법에는 다음의 세가지의 선택가능성이 있다. 첫번째 방법 
은 도움말자동작성묶음을 구입하여 사용하는것 이 다. 두번째 방법은 RTF 파일을 작성하 
는 기능을 가진 본문편집기를 사용하는것 이다. 세번째 방법은 일반적 인 본문편집기를 사 
용하여 수동적으로 RTF 지령을 입력하는것이다. 

만일 규모가 크고 복잡한 도움말파일 을 작성 한다면 도움말자동작성묶음을 사용하는 
것 이 적절한 선택으로 된다. 그러나 작은 규모의 응용프로그람인 경우에는 나머지 두가 
지 방법 으로도 충분하다. 여기서 는 모든 사용자들이 쉽 게 선택할수 있는 세번째 방법 을 
사용한다. 

RTF 파일의 일 반적인 서식 

모든 RTF 파일 에 공통된 기 본서식 이 있다. 우선 파일전체 를 대 괄호로 둘러 싸야 한 
다. 즉 { 로 시작하여 } 로 끝나야 한다. { 의 직후에는 \ rtf 지 령을 지정한다. 이 지 령은 
파일 이 RTF 형식 이 라는것과 사용하는 RTF 의 판본을 표시한다. (여기 에서는 판본 1 을 
사용한다.) 

다음 파일에서 사용하는 문자모임을 지정한다. 일반적으로 ANSI 문자모임을 사용하 
므로 여기에서는 \ ansi 를 지정한다. 파일에서 쓰이는 서체도 지정하여야 한다. 이를 위 
해 \fonttbl 지령을 사용한다. 그리하여 기본적인 RTF 파일의 서식은 아래와 같이 된다. 

八 rtfl \ ansi \ fonttbl... 

Help File Contents 

} 

RTF 파일내부에서는 RTF 지 령의 적 용범위를 지적 하기 위 해 대괄호를 리용한다. 이 
대괄호의 기능은 C 八>+의 원천파일에서 대괄호로 블로크를 정의하는것과 갈다. 

주요한 RTF 지령들 

간단한 도움말파일을 작성하는 경우에 도 가장 중요하고 기 본적 인 몇 개의 RTF 지 령 
을 알고 있어 야 한다. 이 장에서 사용하는 RTF 지 령들을 표 16-1 에 주었다. 


표 16-1. 도움말파일 의 작성 에 서 사용되 는 RTF 지 령 들 




\ ansi 

ANSI 문자모임 을 지 정 한다. 
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\b 

굵은체를 on 으로 한다. 

\bO 

굵은체를 off 로 한다. 

\fn 

n 으로 지정하는 서체를 사용한다. 

\ fsn 

서체의 크기를 n 으로 한다. 

\ fonttbl 

서체표를 정의 한다. 

\ fontnote 

열 쇠단어 및 색 인항목을 지 정 한다. 

\i 

경사체를 on 으로 한다. 

\iO 

경사체를 o 打 로 한다. 

\page 

도움말표제의 끝을 표시한다. 

\par 

단락의 끝을 표시한다. 

\rtfn 

사용하는 RTF 의 판본을 지적한다. 

\tab 

다음의 타브위치로 이동한다. 

\uldb 

다른 표제 에 로의 열 점 련결 (Hot spot link ) 을 표시 

\v 

표제 의 련결 을 작성 八 uldb 와 함께 사용) 


\ ansi 

\ ansi 지령은 ANSI 문자모임을지정 한다. RTF 파일은 \ mac (Macintosh 문자모임 ) 
나 \ pc (OEM 문자모임 ) 등 다른 문자모임 들도 지 원 한다. 그러 나 도움말파일 에 서 일 반적 
으로 쓰이 는것은 ANSI 문자모임 이 다. 

\b 

\b 지령은 굵은체를 on 으로 한다. \bO 지령은 굵은체를 off 로 한다. 그러나 \b 지 
령 이 블로크안에서 사용되는 경우에는 블로크안에서 서술된 본문만이 굵은체로 되므로 
\ b ◦를 사용할 필요는 없다. 아래에 실례를 보여 주었다. 

{\b this is bold} this is not 

이 실례에서는 대괄호안의 본문만이 굵은체로 된다. 


\fn 

\fn 지령은 서체를 선택한다. 서체는 번호로 선택한다. 선택되는 서체의 목록은 \ 
fonttbl 지령을 사용하여 정의하여야 한다. 


\ fsn 

\fsn 지령은 서체를 n 에서 지정한 크기로 한다. 크기는 0.5 포인트단위로 지정한다. 
실례로 \ fs 24 는 서체의 크기를 12포인트로 한다. 
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\ fonttbl 

서체를 사용하기 에 앞서 사용할 서체를 \ font 比)1 지 령안에 렬거하여 야 한다. 아래에 
일반적인 서식을 보여 주었다. 

{\ fonttbl 

{\ f 1 \ family-name font - name ; } 

{\ f 2 \ family-name font-name ； } 

{\ f 3 \ family-name font-name ；} 


{\ fn \ family-name font-name ；} 

} 


family - name 은 서체계렬의 이름 (froman 이나 fswiss 등)이며 font - name 은 그 계 
렬에 부속된 특정 한 서체의 이름 (Times New Roman , Arial 및 Old English 등) 이 다. \ 
f 지령으로 지정하는 서체의 번호는 서체를 선택하는데 쓰인다. 서체계렬이름의 실례를 
아래에 보여 주었다. 


\ froman 

Times New Roman , Palatino 

\ fswiss 

Arial 

\ fmodern 

Courier New , Pica 

\ fscript 

Cursive 

\ fdecor 

Old English 


다음의 실례 는 0 번의 서 체 를 \ fswiss Arial 로 하는것 이 다. 


{\ fonttbl {\f0\fswiss Arial；}} 


\ footnote 

\ footnote 지 령은 도움말파일의 작성에 있어서 가장 중요한 RTF 지령의 하나이 다. 
왜 냐하면 이 지 령을 사용하여 표제 이름, 상황 ID 장 설®달 (Browse sequence ) 이 설정되 
기때문이다. 이 장에서는 다음에 보여 주는 서식의 \ footnote 지령을 사용한다. 
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K {\ footnote string } 

#{\ footnote string } 

+ {\ footnote sequence - name : sequence - order } 

@{\ footnote string } 

$를 사용한 서식은 표제의 제목을 지정한다. 이 제목은 도움말체계의 경 력창 
(History window ) 에 도 표시 된 다. 제 목은 공백 을 포함할수 있 다. 표제 의 제 목은 표제 를 
식별하기 위한것이다. 

K 를 사용한 서식은 string 에 열쇠단어를 지정 한다. 열쇠단어는 공백 을 포함할수 있 
다. 열 쇠단어 는 색 인항목으로서 표시 된 다. 열쇠단어 의 선두문자가 K 인 경 우는 그앞에 
공백을 배치하여야 한다. K 를 사용한 서식은 표제의 제목이 지정되여 있는 경우에만 사 
용된 다. 

#를 사용한 서식은 표제간의 련결이나 교차참조를 작성하는데 쓰이는 상황 ID 를 지 
정한다. 이 상황 ID 는 응용프로그람으로부터 도움말파일의 특정한 부분을 호출하는데 도 
쓰인다. #를 사용한 서식 에서는 string 에 공백을 포함할수 없다. 상황 ID 로 되는 문자렬 
에는 ID 의 값을 가리키는 마크로를 사용하는것 이 일반적 이 다. 

+를 사용한 서식은 열람순서렬을 지정한다. 열람순서렬이란 열람단추(도움말창의 단 
추띠에 표시되는 [«] 단추 및 [>>] 단추)가 눌러웠을 때 련결할 표제들을 결정한것이다. 

+를 사용한 이 서식 에서는 sequence-name 에 순서렬을 지정 하고 sequence-order 
에 순서렬안의 표제들의 위치를 지정한다. 열람순서렬은 sequence-order 의 값에 따라 
영어자모순 또는 번호순으로 된다. 

도움말파일 은 한개 이 상의 열 람순서 렬 을 가질수 있 다. 여 러 개 의 열 람순서 렬 을 정 의 하는 
경 우에 는 \ footnote 지 령 의 sequence-name 과 sequence-order 를 지 정 하여 야 한다. 도움 
말파일에 열람순서렬이 한개밖에 없는 경우는 sequence - name 을 지정할 필요가 없다. 

표준적 인 도움말창문에 열 람단추를 표시 하자면 열 람순서렬을 정의한 도움말파일의 
프로젝트파일의 [ CONFIG ] 부분에 BrowseButtons ( ) 마크로를 정의 하여 야 한다. 

@를 사용한 서식은 설명문을 삽입할 때 사용한다. 


\i 

\i 지 령은 경사체를 on 으로 설정한다. \ i ◦ 지 령은 경사체를 off 로 설정한다. 그러 
나 \ i 지령이 블로크내에서 사용되는 경우에는 블로크안에 서술된 본문만이 경사체로 되 
므로 \ i ◦지령을 사용할 필요가 없다. 


\page 

\ page 지령은 대상항목의 끝을 표시한다. 


\par 
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\ par 지령은 단락의 끝을 표시한다. 이 지령은 행을 바꾸는데 쓰인다. 실례로 한 
행에 두개의 \par 지령이 있으면 행바꾸기가 두번 진행된다. 

\ rtfn 

\rtfn 지령은 사용하는 RTF 의 판본을 지적한다. 이 장에서는 판본 1 을 사용한다. 

\ uldb 

\uldb 지령은 열점련결을 지정한다. 일반적인 서식은 다음과 같다. 

\ uldb text 

text 는 열점의 표준색과 서체로 표시된다. 이 지령은 흔히 \v 지령과 함께 사용된다. 


\ v 지령은 다른 다른 표제에로의 련결을 지정한다. 일반적인 서식은 다음과 갈다. 

\ v context-ID 

context-ID 에는 #\ footoote 지 령을 지정했을 때와 같이 상황 ID 를 지정한다. \ v 
지령에서 지정된 열점을 사용자가 찰칵하면 련결이 진행된다. 


WinHelp 에 대 한 도움말과일의 실 례 

실례 16-1 의 도움말파일은 뒤에서 작성하는 WinHelp ( ) 의 실례프로그람에서 리용 
된다. 이 파일 에 는 WinHelp 도움말파일의 기 본적 인 RTF 지 령 들을 모두 내 포하고 있 다. 
이 파일의 이 름은 HELPTEST.RTF 이 다. 

실례 16-1. Help 프로그람 

{\rtfl\ansi 

{\ fonttbl {\ f 0\ fswiss Arial；} {\f 1 \froman Times New Roman；}} 

\fs40 

\fl 

@{\footnote This is a comment. So is the following.} 

@{\ footnote This is a Sample Help File.} 

${\ footnote Contents} 

Contents of Sample Help File 

\f0 

\fs20 
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\par 

\par 

\tab{\uldb Main Menu \v MenuMain} 

\par 

\tab{\uldb Main Window \ v MainWindow} 

\par 

\tab{\ nldb Main Window Push Button \v PushBu 竹 onMainWin} 
\par 

\tab{\uldb Push Button 1 \v PushButtonl} 

\par 

\tab{\uldb Push Button 2 \v PushButton2} 

\par 

\tab{\nldb Push Button 3 \v PushButton3} 

\par 

\tab{\uldb List Box \v ListBox} 

\par 

\tab{\uldb Check Box \v CheckBox} 

\par 

\par 

\fl 

\fs30 

Select a Topic. 

\fs20 

VO 

\page 

#{\ footnote MenuMain} 

${\ footnote Main Menu} 

K{\ footnote Main Menu} 

{\fs24\b Main Menu} 

\par 

\par 

The main menu allows you to display a sample 
dialog box, activate the help system, display 
information about this program, or terminate 
the program. 

\page 

#{\ footnote MenuMainPU} 

This is the main menu for the program. 
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\page 

#{\ footnote PushButtonMainWin} 

${\ footnote Main Window Push Button} 

K{\ footnote Main Window Push Button} 

{\fs24\b Main Window Push Button} 

\par 

\par 

This is help for the main window push button. 

\par 

{\i This is in italics.} 

\page 

# {\ footnote PushButtonMainWinPU} 

This is the popup for the main window push bu 竹 on. 
\page 

#{\ footnote PushButtonl} 

${\ footnote Push Button 1} 

K{\ footnote Push Button 1} 

+ 八 footnote Push：A} 

{\fs24\b Push Button One} 

\par 

\par 

This is help for the first push button. 

\par 

\par 

See also {\uldb Push Button 2 \v PushBu 竹 on2} 
\page 

#{\ footnote PushButtonlPU} 

This is the popup for the first push button. 

\page 

#{\ footnote PushButton2} 

${\ footnote Push Button 2} 

K{\ footnote Push Button 2} 

+{\ footnote Push：B} 

{\fs24\b Push Button Two} 

\par 

\par 

This is help for the second push button. 

\par 
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\par 

See Also {\ uldb Push Button 3 \v PushButton3} 
\page 

# {\ footnote PushBu 竹 on2PU} 

This is the popup for the second push button. 
\page 

#{\ footnote PushButton3} 

${\ footnote Push Button 3} 

K{\ footnote Push Button 3} 

+{\ footnote Push：C} 

{\fs24\b Push Button Three} 

\par 

\par 

This is help for the third push button. 

\par 

\par 

See Also {\ uldb Push Button 1 \v PushButtonl} 
\page 

# {\ footnote PushBu 竹 on3PU} 

This is the popup for the third push button. 
\page 

#{\ footnote MainWindow} 

${\ footnote Main Window} 

K{\ footnote Main Window} 

{\fs24\b Main Window} 

\par 

\par 

This is the main program window. 

\page 

# {\ footnote MainWindowPU} 

This is the main window popup help message. 
\page 

#{\ footnote DlgPU} 

${\ footnote DlgPU} 

This is a dialog box. 

\page 

#{\ footnote ListBox} 

${\ footnote List Box} 
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K{\ footnote List Box} 

+{\footnote BOX：A} 

{\fs24\b List Box} 

\par 

\par 

This is help for the list box. 

\page 

#{\ footnote ListBoxPU} 

This is the popup for the list box. 

\page 

#{\ footnote CheckBox} 

${\ footnote Check Box} 

K{\ footnote Check Box} 

+{\ footnote BOX:B} 

{\fs24\b Check Box} 

\par 

\par 

This is help for the check boxes. 

\page 

# {\ footnote CheckBoxPU} 

This is the popup for the check boxes. 

\page 

#{\ footnote MenuDlgPU} 

Activates the sample dialog box. 

\page 

# {\ footnote MenuExitPU} 

Termintes the program. 

\page 

# {\ footnote MenuHelpPU} 

Activates the Help System. 

\page 

# {\ footnote MenuAboutPU} 

Displays information about this program. 

\page 

} 

이 파일에서는 ID 이름의 끝이 PU 로 되여 있는 #\ footnote 지령 이 상황의존도움말 
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의 입구점으로 되 여 있다. 기 타 #\footoote 지령들은 표준적 인 도움말창문에서 참조도움 
말을 표시하는데 쓰인다. 

이 파일을 작성한 다음 HCW 번역프로그람을 리용하여 번역 을 진행한다. 출력 되는 
파일 은 HELPTEXT. HLP 로 된 다. HELPTEXT. HLP 는 WinHelpC ) 악 실 례 프로그람에 
서 리용된 다. 그러 나 파일을 번역하기 전에 HELPTEST. RTF 의 프로젝트 파일의 [MAP] 
부분에 아래와 같은 MAP 명 령문들을 정의하여 야 한다. 이 값들은 상황의존도움말을 지 
원하는데 사용된다. 




PushButtonlPU 

700 

PushButton2PU 

701 

PushButton3PU 

702 

ListBoxPU 

703 

CheckBoxPU 

704 

MainWindowPU 

705 

PushButtonMainWinPU 

706 

DigPU 

707 

MenuDlgPU 

708 

MenuExitPU 

709 

MenuHelpPU 

710 

MenuAboutPU 

711 

MenuMainPU 

712 



이렇게 많은 MAP 명령들을 정의하기 위한 가장 간단한 방법은 도움말프로젝트에 매 
프파일 을 포함시 키 는것 이 다. HCW 의 경 우는 매 프파일안에 서 값에 식 별 자를 대 응시 키 기 
때문에 다음의 서식을 사용한다. 


identifierl valuel 
iden 仕 fier2 value2 
identifiers value3 


iden 仕 fierN valueN 


례 를 들면 실례 도움말파일 에 서 사용되 는 매 프파일 (이 름이 HELPTEXT.HM 인 본문 
파일)의 내용은 다음과 갈다. 
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PushButtonlPU 700 

PushBu 竹 on2PU 701 

PushBu 竹 on3PU 702 

ListBoxPU 703 

CheckBoxPU 704 

MainWindowPU 705 

PushBu 竹 onMainWinPU 706 

DlgPU 707 

MenuDlgPU 708 

MenuExitPU 709 

MenuHelpPU 710 

MenuAboutPU 711 

MenuMainPU 712 


표준도움말창에 열 람단추를 표시 하자면 프로젝 트과일 의 [ CONFIG ] 부분에 
BrowseButtons ( ) 마크로를 지 정하여 야 한다. 도움말창문에 제 목을 표시 하자면 Help 
Workshop 의 [ Options ] 대화칸에서 설정 한다. 제목을 설정하지 않은 경우에는 체계설정 
의 [Windows Help ] 라는 제목이 리용된다. 이 실례에서는 제목을 [Sample Help File ] 
로 설정한다. 

파일을 번역하면 HELPTEXT.HLP 라는 도움말파일이 생성된다. 이 도움말파일은 후 
에 작성 하는 WinHelp () 의 실례 프로그람의 EXE 파일과 같은 등록부에 들어 있어 야 한다. 
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다시 한보 전진 


WinHelp 의 마크로 

BrowseButtonsO 마크로는 WinHelp 의 도움말체 계 가 지 원하는 많은 마크 
로들중의 하나에 불과하다. 기 타 마크로들을 아래 에 보여 주었다. 


Annotate ( ) 

설명 문칸을 표시 한다. 

Back ( ) 

앞의 표제로 돌아 간다. 

DisableButton ( ButtonID ) 

ButtonID 에서 지정된 표준의 도 

움말단추를 무효로 한다. 

EnableButton ( ButtonID ) 

ButtonID 에서 지정된 표준의 도 

움말단추를 유효로 한다. 

Exit ( ) 

도움말체계를 완료한다. 

CotoMark ( mark ) 

SaveMarkO 로 설정된 바로 앞의 

표식으로 이행한다. 

History ( ) 

경 력목록을 표시 한다. 

Next ( ) 

열람순서 렬의 다음 표제로 전진한 

다. 유효한 열람순서렬안에서 실행 

되여야 한다. 

Prev ( ) 

열람순서렬의 앞표제로 돌아 간 

다. 유효한 열람순서렬내에서 실행 

되여야 한다. 

Print ( ) 

현재의 표제를 인쇄한다. 

SaveMark ( ) 

도움말파일 의 현재위치를 mark 에 

지적한 표식으로 보관한다. 


도움말 마크로는 여러가 지 방법으로 실행 할 수 있 다. 실례로 
BrowseButtons ( ) 등의 마크로들은 도움말의 프로젝트파일안에서 지정되지만 
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도움말파일안에서 실행되 는 마크로들도 있다. 도움말파일내 에서 마크로를 실행 
하려면 다음과 같은 서식의 \ footnote 지령을 리용한다. 

! {\ footnote macro ( )} 

macro 에 실행하려는 마크로의 이름을 지정한다. 실례로 아래의 지령은 열 
람순서렬의 앞 표제에로 돌아 가는 지령이다. 

! {\ footnote Prev( ) } 

WinHelp 의 프로젝 트를 작성 할 때 도움말마크로를 사용하면 도움말정 보를 
사용자에게 표시하는 방법을 할수 있다. 앞으로 WinHelp 를 본격적으로 사용 
할수 있게 준비하자면 도움말의 마크로사용방법을 잘 알아 두어야 한다. 
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WinHelpf 》를 사용한 도움말의 기동 


RTF 파일 을 작성 하고 그것 을 HLP 형 식 으로 번역 하면 응용프로그람에 서 
WinHelpC ) 라는 API 함수를 불러 내 여 도움말정 보를 호출할수 있다. 아래 에 이 API 함 
수의 선언을 준다. 

BOOL WinHelp(HWND hwnd , LPCSTR filename , UINT command , 

DWORD extra ); 


hwnd 에는 도움말을 기동하는 창문의 손잡이를 설정 한다. filename 에는 표시 하려는 
도움말파일의 이 름을 구동기 이 름 및 경 로이 름과 함께 설정한다. command 에 는 
WinHelp ( ) 함수에 보내 려는 지 령을 설정 한다. 

command 에 설정할수 있는 지 령 들을 아래 에 보여 주었 다. 


HELP_COMMAND 

도움말마크로를 실행한다. 

HELP-CONTENTS 

(낡은 지 령 이 므로 대 신 HELP_FINDER 를 사용 
할것) 

HELP CONTENT 

지정된 표제를 표시 한다. 

HELP_CONTEXTMENU 

튀 여나오기차림 표를 표시한 다음 상황의존도움말 
을 표시한다. 

HELP CONTEXTPOPUP 

상황의존도움말을 표시 

HELP FINDER 

표준 도움말대상항목창을 표시 

HELP—FORCEFILE 

파일을 강제적으로 표시 

HELP_HELPONHELP 

도움말의 사용방법을 표시 

WINHELP 32. HLP 파일 이 요구된 다. 

HELPJNDEX 

(낡은 지령 이므로 대신 HELP_FINDER 를 사용 
할것) 

HELP KEY 

열쇠단어로 지정된 표제를 표시 

HELP MULTIKEY 

다중열쇠 단어 로 지 정 된 표제 를 표시 

HELP—PARTIALKEY 

열 쇠 단어 와 부분적 으로 일 치 하는 표제 를 표시 

HELP QUIT 

도움말창문을 닫는다. 

HELP_SETCONTENTS 

표제의 차례를 설정 
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HELP _ SETPOPUP_POS 

도움말체 계 에 의 해 표시 되 는 튀 여 나오기 창문의 
위치를 설정 

HELP—SETWINPOS 

도움말창문의 크기를 설정하고 필요하다면 표시 

HELP_TCARD 

련습카드형식의 도움말을 사용하는 경우 이 지령 
을 다른 지 령과 OR 로 결합하여 지정 

HELP WM HELP 

상황의존도움말을 표시 


이 지령들가운데는 추가정보가 필요한것들도 있다. 추가정보는 extra 에 설정한다. 
매 지 령 에서 extra 에 설정하는 값을 아래 에 보여 주었다. 


지 령 

extra 에 설 정 하는 값 

HELP_COMMAND 

마크로가 들어 있는 문자렬의 지시자 

HELP CONTENTS 

미사용(령을 설정) 

HELP CONTENT 

표제의 상황 ID 

HELP CONTEXTMENU 

(본문을 참조) 

HELP CONTEXTPOPUP 

표제 의 상황 ID 

HELP FINDER 

미사용(령을 설정) 

HELP FORCEFILE 

미사용(령을 설정) 

HELP HELPONHELP 

미사용(령을 설정) 

HELP INDEX 

미사용(령을 설정) 

HELP KEY 

열쇠단어 가 들어 있는 문자렬의 지시 자 

HELP 一 MULTIKEY 

MULTIKEYHELP 구조체의 지시자 

HELP—PARTIALKEY 

부분적 인 열쇠단어가 들어 있는 문자렬의 지시자 

HELP QUIT 

미사용(령을 설정) 

HELP SETCONTENTS 

표제 의 상황 ID 

HELP SETPOPUP POS 

POINTS 구조체의 지시 자 

HELP SETWINPOS 

HELPWININFO 구조체의 지시자 

HELP _ WM_HELP 

(본문을 참조) 


HELP _ WM_HELP 와 HELP_CONTEXTMENU 아사 는 extra 에 설정 하는 값이 다른 
지령보다 좀 복잡하다. 이 두 지령에서는 extra 에 DWORD 형의 배렬에 대한 지시자를 
설정 하는데 이 배 렬에는 두개의 값을 설정한다. 첫번째 값은 조종체 (누르기단추，편집칸 
등) 또는 차림 표항목의 ID 를 설 정한다. 

두번째 값에는 그 조종체나 차림표항목과 관련된 도움말정보의 상황 ID 를 설정한다. 
배 럴의 끝에 는 령 을 두개 배 치한다. 이 두개의 지 령은 상황의 존도움말을 지 원하며 뒤 에 
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서 설명 하는 竹 ^// ELP 통보문과 WM_CONTEXT 통보문을 처리할 때 사용된다. 

WM.HELP ■보문과 1/ LC 0 NTEXT 틍보문에 대한 응답 


이 장을 시 작할 때 설명 한것처 럼 도움말에는 크게 참조도움말과 상황의존도움말의 
두가지 부류가 있다. 정확한 프로그람에서는 사용자가 차림표에서 [ Help ] 를 선택하거나 
또는 특정한 상황에서 [ F 1] 건을 누르면 참조도움말이 표시된다. (표준의 도움말창이 표 
시된 다.) 

상황의존도움말은 조종체 나 창문을 마우스의 오른쪽 단추로 찰칵하거나 好]단추를 
사용하거 나 혹은 특정한 상황에서 [ F 1] 건을 누르면 표시된다. ([ F 1] 건 사용방법에서의 
차이점에 대해서는 다음 절에서 설명한다.) 

프로그람은 각이한 조작의 도움말요청에 대해 각이한 방법으로 응답할수 있어야 한 
다. 그러므로 도움말요청을 구별하기 위 한 어 떤 수단이 필요하다. Windows 2000 은 이 
수단을 정 확히 제공하고 있다. 

[ F 1] 건 이 늘리우든가 [刊단추가 리용되 였 을 때 는 능동인 창문에 자동적 으로 
WM_HELP 통보문이 전송된다. 창문이 나 조종체를 마우스의 오른쪽 단추로 눌렀을 때 는 
조종체를 포함하고 있는 창문에 WM_CONTEXTMENUli 문。' 전송된다. 직결도움말을 
정 확하게 동작시키 려 면 이 두가지 통보문을 구별하여 처 리하여 야 한다. 여기 에서는 두가 
지 통보문의 처 리 방법을 설명한다. 


이식과 관련한 요점 : WM—HELP 통보 문과 WM _ CONTEXTMENU 통보 문은 Windows 
3.1 이나 Windows NT 3. 51 에서는 지원되지 않는다. 그러므로 낡은 프로그람을 
Windows 2000 에 이식할 때 필요에 따라 이 통보문들을 처리하는 기능을 추가하여야 
한다. 


WM _ H 타 _P 통보문 

프로그람에 抑여之//五 LP 통보문이 보내 졌을 때 IParam 에는 도움말요청 내 용을 가리키 
는 HELPINFO 구조錢와 지시자가 보관되여 있다. //五 LP / Mro 구조체의 정의를 아래에 보 
여 주었다. 


typedef struct tagHELPINFO 
{ 


UINT cbSize； 
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int iContextType； 
int iCtrlld； 

HANDLE hltemHandle； 


DWORD dwContextld； 

POINT MousePos； 

} HELPINFO； 

cbSize 에 는 HELPINFO 구조체 의 크기 가 보관된 다. 

iContextType 에는 도움말을 요청하고 있는 객체의 종류가 보관된다. 이 값은 차림 
표항목의 경우에는 HELPINFO_MENUITEM 으로 되며 창문 또는 조종체의 경우에는 
HELPINFO_WINDOW 로 된 다. iCtrlld 에 는 조종체 , 창문 또는 차림 표항목의 ID 가 보 
관된 다. 

hltemHandle 에는 조종체，창문 또는 차림표항목의 손잡이가 보관된다. 
dwContextld 에 는 창문 또는 조종체 의 상황 ID 가 보관된 다. MousePos 에 는 현재 마우스 
의 위치가 보관된다. 

많은 경 우에 프로그람은 WMJHELP 통보문에 대 한 응답으로서 상황의존도움말을 튀 
여 나오기 창문에 표시한다. 

실례 로 조종체 의 상황도움말을 표시 하자고 하면 창문손잡이 를 가리키는 
hltemHandle 의 값을 첫 파라메 터 로 하여 WinHelpC ) 를 호출한다. (이 것 은 목적 하는 조 
종 체 의 손 잡 이 이 다 . ) 이 경 우 에 는 WinHelp ( ) 의 command 파 라 메 터 에 
HELP _ WM_HELP 를 설정 하고 extra 파라메 터 에 ID 를 보관한 배 럴의 지시 자를 설정 한 
다. (구체 적 인 방법 에 대 해 서 는 실례 프로그람에 서 보여 준다. ) 

이렇게 하여 WinHelp ( ) 를 호출하면 우선 배 렬로부터 hltemHandle 로 지정된 조종 
체와 일치하는 조종체 ID 가 검색된다. 그것에 대응하는 상황 ID 을 사용하여 상황의존도 
움말이 얻어 진다. 종국적으로 표준의 도움말창문이 아니라 위여나오기창문에 도움말정 
보가 표시된다. ( HtmlHelp ( )를 사용하는 경우에도 이와 류사한 처리가 진행된다.) 

WM_HELP 통보문에 대 해 상황의 존도움말을 표시하여 응답하는것 은 일 반적 인 처 리 
이지 만 이 방법 에 전혀 문제 가 없는것은 아니 다. 앞에서 설명한것 처 럼 [ F 1] 건은 참조도 
움말 또는 상황의존도움말의 어느것을 호출하는데도 쓰인다. 여기서 [ F 1] 건의 사용방법 
을 설명해 보자. 

기 본창문이 입 력 초점 을 가지 고 있을 때 (다시 말하여 어 떤 새 끼 창문，조종체 또는 차 
림표가 선택 되 여 있지 않을 때 ) 에 [ F 1] 건 이 눌러 우면 표준도움말창문이 기 동되 여 참조 
도움말이 표시 된다. 그러 나 조종체 , 차림 표 또는 새 끼창문이 능동인 때 [ F 1] 건 이 눌러 
우면 상황의존도움말이 표시된다. 

이것을 구별하는 리유는 사용자가 제 일 웃준위의 창문에서 [ F 1] 건을 눌렀을 때 프 
로그람전반에 대 한 도움말을 요청한것 이 지 부분적 인 도움말을 요청 한것 이 아니 기 때 문이 
다. 이 요청에 대한 응답으로서 도움말체계전체를 기동한다. [ F 1] 건이 눌러워 졌을 때 
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조종체 (또는 새 끼 창문) 가 능동으로 되 여 있 다면 사용자가 특정한 항목과 관련 한 도움말 
을 요청한것 이 므로 상황의 존도움말을 표시 하게 된 다. 

[ F 1] 건을 사용하여 참조도움말과 상황의존도움말가운데 어느것 이 나 기동할수 있으 
므로 프로그람에서 두가지 요청을 구별하려면 어떻게 하면 좋겠는가? [ F 1] 건을 눌렀을 
경우에 요청의 종류에 관계 없이 WM_HELP 통보문이 발송된다. 그러나 요청을 구별하 
는 방법 은 아주 간단하다. hltemHandle 에 보관되 여 있는 손잡이 가 기 본창문의 것 이 라면 
참조도움말을 표시하면 된다. 그렇지 않은 경우에는 앞에서 본 방법으로 상황의존도움말 
을 표시하면 좋다. 

WM-CONTEXTMENU 통보문 

사용자가 마우스의 오른쪽 단추를 찰칵하면 프로그람에 WM—CONTEXTMENU 통：支 
문이 발송된다. 이때 wParam 에는 도움말의 대상으로 되는 조종체 또는 창문의 손잡이 
가 보관되 여 있다. 사용자가 조종체 를 오른쪽 찰칵한 경 우는 창문의 손잡이 로서 
wParam 의 값을 지 정 하여 WinHelp ( )를 호출한다」: WinHelp ( ) 의 첫 과라메 터 는 창문 
의 손잡이 이 다.) 이 때 co_and 파라메 터 에 HELP—CONTEXTMENU 를 설정 하고 
extra 파라메 터 에 ID 를 보관한 배 렬의 지시 자를 설정 한다. (같은 방법 이 HtmlHelp ( ) 에 
서도 리용된다.) 

[개단추를 표시하는 방법 


이미 설명한것처 럼 상황의존도움말을 표시하기 위한 방법의 하나로서 [和단추를 사 
용할수 있다. 창문에 [幻 단추를 표시하자면 창문의 형식 에 WS _ EX_CONTEXTHELP 를 
포함시 켜 야 한다. WS _ EX_CONTEXTHELP 는 확장형 식 이 므로 창문을 작성 할 때 
CreateWindow ( ) 가 아니 라 CreateWindowEx ( )를 사용하여 야 한다. 대화칸에 [?] 단 
추를 표시하려는 경우에는 대 화칸의 형식 에 DS _ CONTEXTHELP 를 포함시켜 야 한다. 

참고 : 최신형식의 창문으로 하려면 기본적으로 대화칸에 [幻단추를 표시 할것을 권고 한 
다. 그러나 상황에 따라 기본창문에 [?] 단추를 표시할수도 있다. 


WinHelp 의 실례프로그람 


지금까지 설명한 고전적인 형식의 도움말체계를 작성하기 위한 여러가지 기술들을 
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실제로 사용해 보자. 실례 16-2 의 프로그람은 참조도움말과 상황의존도움말의 적용실례 
이다. 이 프로그람에서는 앞에서 작성한 도움말파일을 사용하며 WinHelp () 를 여러가지 
방법으로 호출한다. 프로그람의 실행결과는 그림 16-3 과 같다. 

실 례 16-2. HelpTest 프로그람 


// WinHelp 도움말체 계 의 실례 


ttinclude〈windows. h> 
ttinclude ’’helptest.h” 


ttdefine NUMSTRINGS 6 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM); 
BOOL CALLBACK DialogFunc(HWND, UINT, WPARAM, LPARAM) ； 

char szWinName[] = ’’MyWin”; // 창문클라스의 이름 

HINSTANCE hlnst； 

// 조종체의 ID 를 상황 ID 에 대응시킨다 . 

DWORD HelpArray[] = { 

IDD—PB1, IDH—PBl, 

IDD.PB2, IDH_PB2, 

IDD_PB3, IDH_PB3, 

ID_PB0, IDH_PB0, 

IDD_LB1, IDH_LB1, 

IDD.CBl, IDH_CB1, // 여기서는 두개의 검사칸에 
IDD.CB2, IDH.CB1, // 같은 상황 ID 를 대 응시 키 고 있 다 . 

0 , 0 

}； 

char lbstring [6] [40] = { 

"one”, "two，，, ” three", 

"four", "five”, ，’ six” 

}; 


int WINAPI WinMain (HINSTANCE hThisInst, HINSTANCE hPrevInst, 
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LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 


// 창문콜라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ; 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계 설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이론 
wcl. hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl. IpszMenuName = "HelpDemoMenu" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 


// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


A 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindowEx ( 

WS_EX_CONTEXTHELP, // [?] 단추를 표시한다 . 
szWinName, // 창문를라스의 이름 
"A WinHelp Demonstration", // 제목 
WS_SYSMENU | WS_SIZEBOX, 

CW_USEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
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CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 너비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 높이 는 Windows 가 결정 하게 한다 . 


// 어미창문은 없다 . 

// 콜라스차림 표의 덧쓰기는 하지 않는다 . 
// 실체의 손잡이 
// 추가파라메터 는 없 다 . 


NULL, 

NULL ， 


hThisInst, 

NULL 


hlnst = hThisInst ； // 현재의 실체손잡이를 보관한다 . 

// 건반가속기를 적재 한다 . 

hAccel = LoadAccelerators (hThisInst, "HelpDemoMenu") : 

// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while(GetMessage(&msg , NULL, 0, 0)) 

{ 

if(! TranslateAccelerator(hwnd, hAccel, &msg)) { 
TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage(Smsg) ; // Windows 2000 에 조종을 넘 긴다 . 

} 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 


WPARAM wParam, LPARAM IParam) 
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switch (message) { 
case WM_CREATE ： 

// 조종체 (새끼 창문)를 작성 한다 . 

CreateWindow ( 

"BUTTON", // 조종체의 콜라스이름 
"Main Window PB", // 제목 

BS_PUSHBUTTON | WS_CHILD | WS_VISIBLE, // 누름단추 

10, 60, 120, 30, 

hwnd, // 어미는 기본창문이다 . 

(HMENU) ID_PB0, // 조종체의 ID 
hlnst, // 프로그람의 실체손잡이 
NULL // 추가파라메터 는 없 다 . 

)； 

break ； 

case WM_HELP ： // 사용자가 [F1] 건을 눌렀든가 [?] 단추를 사용하였다 . 
if(((LPHELPINFO) IParam) - MContextType == 

HELPINFO_MENUITEM) { 

// 차림표와 관련한 도움말요청 
switch (((LPHELPINFO) IParam)-MCtrlld) { 
case IDM_DIALOG ： 

WinHelp(hwnd, "helptest.hlp", HELP_CONTEXTPOPUP, 
(DWORD) IDH_MENUDLG) : 

WinHelp(hwnd, "helptest. hlp>HlpWin2", HELP_CONTEXT, 
(DWORD) IDH_MENUDLG); 

break ； 

case IDM_HELP ： 

WinHelp(hwnd, "helptest.hip", HELP_CONTEXTPOPUP, 
(DWORD) IDH_MENUHELP) : 

break ； 

case IDM_HELPTHIS ： 

WinHelp(hwnd, "helptest.hip", HELP_CONTEXTPOPUP, 
(DWORD) IDH_MENUABOUT ); 

break ； 

case IDM_EXIT ： 

WinHelp(hwnd, "helptest.hip", HELP_CONTEXTPOPUP, 
(DWORD) IDH_MENUEXIT) : 

break ； 

default ： 
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// 차림표띠가 선택되였으나 반전표시된 항목은 없다 . 

WinHelp(hwnd, "helptest.hlp", HELP_CONTEXTPOPUP, 
(DWORD) IDH_MENUMAIN) : 

} 

} 

else 

if(((LPHELPINFO) lParam)->hItemHandle != hwnd) { 

// 조종체와 관련한 상황도움말 

WinHelp ((HWND) ((LPHELPINFO) lParam) ->hItemHandle, 

"helptest. hip", HELP_WM_HELP, 

(DWORD) HelpArray); 

} 

else { 

// 기본창문의 표준도움말 

WinHelp (hwnd, "helptest. hip", HELP_KEY, 

(DWORD) "Main Window") : 

} 

break ； 

case WM_CONTEXTMENU : // 사용자가 마우스의 오른쪽 단추를 찰칵하였다 . 
if((HWND) wParam != hwnd) 

// 조종체와 관련한 상황도움말 

WinHelp ((HWND) wParam, "helptest. hip", 

HELP_CONTEXTMENU, (DWORD) HelpArray); 

else 

// 기본창문과 관련한 상황도움말 
WinHelp (hwnd, "helptest. hip", 

HELP_CONTEXTPOPUP, IDH_MAIN) : 

break ； 

case WM_COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM_DIALOG ： 

DialogBox(hlnst, "HelpDemoDB", 

hwnd, (DLGPROC) DialogFunc) : 

break ； 

case IDM_HELP ： // 차림표로부터 도움말이 요청되 였다 . 

WinHelp (hwnd, "helptest. hip", HELP_FINDER, 0 )； 
break ； 

case IDM_HELPTHIS ： 
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MessageBox(hwnd, "Help System Sample Program VI. 0", 
"About", MB_OK); 

break ； 

case IDM_EXIT ： 

response = MessageBox(hwnd, "Quit the Program?", 
"Exit", MB_YESNO); 
if (response == ID YES) PostQuitMessage (0) : 
break ； 

} 

break ； 

case WM_DESTROY ： // 프로그람을 끝낸다 . 

WinHelp(hwnd, "helptest.hlp", HELP_QUIT, 0); 
PostQuitMessage (0) : 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam) : 

} 

return 0 ； 

} 

// 실례프로그람의 대화함수 

BOOL CALLBACK DialogFunc(HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

int i ； 


switch (message) { 

case WM_HELP ： // 사용자가 [FI] 건을 눌렀든가 [ ? ] 단추를 사용하였다 . 
// 조종체와 관련한 상황도움말 

WinHelp ((HWND) ((LPHELPINFO) IParam) ->hItemHandle, 

"helptest. hip", HELP_WM_HELP, 

(DWORD) HelpArray); 
return 1 ； 

case WM_CONTEXTMENU : // 사용자가 마우스의 오른쪽 단추를 찰칵했 다 . 
if((HWND) wParam != hdwnd) 

// 조종체 와 관련한 상황도움말 
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WinHelp((HWND) wParam, "helptest.hlp", 

HELP.CONTEXTMENU, (DWORD) HelpArray) ； 

else 

// 대화함수와 관련한 상황도움말 
WinHelp(hdwnd, ” helptest. hip” , 

HELP_CONTEXTPOPUP, IDH.DLG) ； 

return 1 ； 

case WM_COMMAND ： 
switch (LOWORD (wParam)) { 
case IDCANCEL ： 

WinHelp(hdwnd, "helptest.hip", HELP_QUIT, 0); 
EndDialog (hdwnd, 0); 
return 1; 
case IDD_PB1: 

MessageBox (hdwnd, ’’Push Button 1”, 

"Button Press”, MB_OK) ； 

return 1 ； 
case IDD_PB2 ： 

MessageBox(hdwnd, ” Push Button 2”, 

"Button Press”, MB_OK) ； 

return 1; 
case IDD_PB3 ： 

MessageBox(hdwnd, ” Push Button 3 "， 

"Button Press", MB_OK); 

return 1; 

} 

break ； 

case WMJNITDIALOG ： // 목록칸을 초기화한다 . 
for(i=0 ； i<NUMSTRINGS ； i++) 

SendDlgltemMessage (hdwnd, IDD_LB1, 

LB 一 ADDSTRING, 0, (LPARAM) lbstring [i]) ； 
return 1 ； 


return 0 ； 
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이 프로그람은 아래의 자원파일을 리용한다. 

// 도움말체계의 실례 
ttinclude 〈 windows. h> 

#include "helptest. h" 

HelpDemoMenu MENU 

{ 

POPUP "SDialog" 

{ 

MENUITEM "&Dialog\tF2", IDM_DIALOG 
MENUITEM "E&xit\tCtrl+X", IDM_EXIT 

} 

POPUP "&Help" 

{ 

MENUITEM "SHelp Topics", IDM_HELP 
MENUITEM "&About", IDM_HELPTHIS 

} 

} 

HelpDemoMenu ACCELERATORS 

{ 

VK_F2, IDM_DIALOG, VIRTKEY 
"~X", IDM_EXIT 

} 

HelpDemoDB DIALOGEX 10, 10, 140, 110 
CAPTION "Help Demonstration Dialog" 

STYLE WS_POPUP | WS_SYSMENU | WS_VISIBLE | DS_CONTEXTHELP 

{ 

DEFPUSHBUTTON "Button 1", IDD_PB1, 11, 10, 32, 14 
PUSHBUTTON "Button 2", IDD_PB2, 11, 34, 32, 14 
PUSHBUTTON "Button 3", IDD_PB3, 11, 58, 32, 14 
PUSHBUTTON "Cancel", IDCANCEL, 8, 82, 38, 16 
AUTOCHECKBOX "Check Box 1", IDD_CB1, 66, 50, 60, 30 
AUTOCHECKBOX "Check Box 2", IDD_CB2, 66, 70, 60, 30 
LISTBOX IDD_LB1, 66, 5, 63, 33, LBS_NOTIFY | 
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WS—BORDER | WS.VSCROLL | WS.TABSTOP 

} 

머리부파일 HELPTEST.H 의 내용을 아래에 보여 주었다. 


ttdefine IDM.DIALOG 100 

Mefine IDM.EXIT 101 

ttdefine IDM.HELP 102 

#define IDM.HELPTHIS 103 

#define IDD_PB1 200 

Mefine IDD_PB2 201 

#define IDD_PB3 202 

#define IDD_LB1 203 

Mefine IDD_CB1 205 

Mefine IDD_CB2 206 

#define ID_PB0 300 

Mefine IDH.PBl 700 

Mefine IDH.PB2 701 

Mefine IDH_PB3 702 

#define IDH.LBl 703 

#define IDH_CB1 704 

Mefine IDH.MAIN 705 

Mefine IDH.PBO 706 

Mefine IDH.DLG 707 

#define IDH_MENUDLG 708 

#define IDH_MENUEXIT 709 

#define IDH_MENUHELP 710 

Mefine IDH.MENUABOUT 711 

Mefine IDH.MENUMAIN 712 
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£iles 旦 dit Bookrrrark 으 ptitjns JHelp 
Contents | Index | 旦 ack | Print | 

Contents of Sample Help File 

Main Menu 


Contents | 丄 ndex | Back | Print ] — 


■ -ln|x| 


iformation about this program, or 


Select a Topic. 





]Ji2Sl 


Main Window I 레 

n ?| 


I This is the popup for the seco^^^H 
I nd push button 

^^Buttoi^^^^^Cneck Box 1 


그림 16-3. WinHelp 의 실례프로그람의 실행결과 


WinHelp 실례프로그람의 상세 


프로그람의 대부분의 내용은 쉽게 리해할수 있다. 그러나 주의해 야 할 부분이 있다. 
우선 HelpArray 의 선 언 이 다. 이 배 럴 은 조종체 ID 와 상황 ID 를 대 응시 키 기 위 한것 이 다. 

HELPTEST.H 라는 머 리부파일에서 11가1_로 시 작되는 마크로들에는 도움말파일을 
작성할 때 HELPTEST.PRJ 파일 에 서 정 의한것 과 같은 값들이 설정되 여 있다. 두개 의 
검사칸에 같은 상황 ID 가 대 응되 여 있는 점 에도 주의 를 돌려야 한다. 이 렇게 한다고 해 
서 말썽거리가 생기지는 않는다. 그것은 두개이상의 조종체에 갈은 상황의존도움말을 표 
시 하는 경 우에 는 갈은 도움말정 보를 중복하여 작성할 필요가 없기 때 문이 다. 

이 프로그람에서 기본창문과 대화칸의 량쪽에 [刊단^를 표시하고 있는 점에 대해서 
도 주의 를 돌려야 한다.단추는 대 화칸에서 사용하는것 이 일반적 이지만 기 본창문에서 
도 사용한다. 여 기 에도 중요한 문제 점 이 있기때 문이 다. [?] 단추를 눌러서 ?표식 이 붙은 
마우스는 그것 이 표시 되 여 있는 창문에 만 통보문을 보낸다. 실례프로그람을 사용하면 이 
것을 실제로 확인할수 있다. 

우선 대 화칸을 표시 하고 [?] 단추를 찰칵한다. 다음 마우스유표를 대 화칸의 밖으로 
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이동한다. 마우스유표의 ?표식 이 표시되지 않은것을 보게 될것 이 다. ?표식은 그것 이 정 
의되 여 있는 창문에 만 표시된다. 

또 한가지 주의 를 돌려야 할 점 이 있 다. 기 본창문의 내 부에 는 독립 적 인 누름단추가 
있다. 이 단추는 기본창문의 새끼창문으로 되여 있다. 이 단추가 입 력초점을 가지고 있을 
때 (선택되여 있을 때) [ F 1] 건을 누르면 누름단추의 상황의존도움말이 튀여나오기 된다. 

그러나 이 단추가 입력초점을 가지고 있지 않은 상태 에서 [ F 1] 건을 누르면 기본창 
문이 능동이므로 기본도움말창문이 표시된다. 이것은 Windows 의 표준설계지침에서 주 
장하는 도움말의 동작방식이 다. 


WinHelp 에서 2차 창문들 리용하는 방법 


WinHelp 프로젝 트에 는 도움말의 2 차 창문을 추가할수도 있다 . 2 차 창문은 단추띠 를 
가지 지 만 차림 표띠 는 없 다. 그러 므로 표준의 참조도움말창문보다는 작고 상황의 존도움말 
의 튀여나오기창문보다는 크게 된다. 2 차 창문은 그것을 닫을 때까지 능동으로 되여 있 
지만 사용자는 응용프로그람의 다른 부분을 계속 사용할수 있다. 

2 차 창문을 작성하는 방법 은 아주 간단하다. 우선 그것 을 도움말프로젝 트에 추가한 
다. 그러 자면 HCW 번역기의 [ Windows ] 추가선택 항목에서 창문의 형 태를 설정해 주기 
만 하면 된 다. 2차 창문의 종류에 는 아래 와 갈은 세 가지 가 있 다. 


• Procedure 

• Reference 

• Error Message 


Procedure 창문은 [ HelpTopic ], [ Back ] 및 [ Options ] 라는 단추를 가지고 있는 작 
은 창문이 다. 이 창문은 화면의 오른쪽 우에 표시된다. Reference 창문도 [Help Topic ], 
[ Back ] 및 [ Options ] 단추들을 가지고 있지만 약간 더 큰 창문으로 된다. 이 창문은 화 
면의 왼쪽 우에 표시된다. Error Message 창문은 단추가 없는 작은 창문이 다. 

2 차 창문을 사용하려 면 WinHelp ( ) 를 호출할 때 아래 와 같은 서 식 으로 도움말파일 
의 이름과 창문이름을 설정한다. 

filename〉windowname 

실례로 2 차 창문의 이름을 HlpWin 2 로 한다면 아래의 코드로 앞의 실례프로그람의 
기 본차림 표의 [ Dialog ] 항목과 관련한 상황도움말을 2 차 창문에 표시 할수 있다. 

winHelp ( hwnd , “ helptest . hlp > HlpWin 2”, HELP _ CONTEXT , 

( DWORD ) IDH _ MENUDLG ) : 
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HlpWin 2 의 종류를 Reference 창문으로 하면 아래 와 같은 창문이 표시 된다. 


Dialog Help 

^■텔^^_| 

Exit CtrkX | 


■ ?lx| 


Main W 



Jopics I B，J I Options | < 

Activates the sample dialog box 


도움말에 2 차 창문을 추가하는 방법은 간단하지만 그렇 게 하여 WinHelp 응용프로그 
람의 겉모양을 크게 개선할수 있다. 프로그람의 여러가지 장면에서 어떠한 형식의 창문 
을 사용하는것이 적절하겠는가 하는것은 자신들이 직접 시험해 보는것이 좋다. 


HTML 도움 말의 사용방법 


WinHelp 에 기초한 도움말은 광범히 쓰이지만 그것 을 강력 한 HTML 도용말로 바꾸면 
최신의 열람기지향대면부를 가진 도움말체계를 작성할수 있다. 

HTML 도움말은 Windows 2000 에서 쓰고 있는 형식 이 다. HTML 도움말은 HTML 
도움말표시기 (HTML Help Viewer ) 에 의해 표시된다. 이것은 Internet Explorer 와 류 
사한 열 람기형식의 창문이 다. HTML 도움말의 례를 그림 16-4 에 보여 주었 다. 



그림 16-4. HTML 도§말창문의 실례 
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HTML 도움말은 WinHelpC ) 가 아니 라 HtmlHelpC ) 를 호출하여 표시 한다. HTML 
도움말을 리용하는 경 우에 도 프로그람은 지 금까지 설명 한 WM_HELP 통보문과 
WM_CONTEXTMENU 통 i 문을 접수한다. 프로그람에 서 변경 이 필요한 개 소는 이 통보 
문들에 응답하는 방법뿐이다. 

HTML 은 RTF 가 아니 다 

HTML 도움말에 서 는 도움말정 보를 보관하기 위 하여 RTF 파일 이 아니 라 HTML 파일 
을 리용한다. 현재 대 다수의 프로그람작성 자들이 HTML 에 대 한 기 초지 식 을 가지 고 있 
으므로 여 기 서 는 HTML 에 대 한 설명 은 하지 않는다. 

그러 나 불과 몇 개 안되 는 HTML 지 령 만으로도 효과적 인 도움말정 보를 작성 할수 있 
다는것을 알아 둘 필요가 있다. 즉 HTML 에 대한 해박한 지식이 있으면 물론 편리하겠 
지만 꼭 필요한것은 아니 다. 하이퍼 련결 (Hyper link) 에 대 한 지식만 있으면 HTML 도 
움말파일을 작성할수 있 다. 


HTML Help Workshop 

본문편집기로 도움말파일을 간단히 작성할수 있는 고전적인 도움말체계와는 달리 
HTML 파일을 작성 하려 면 Microsoft HTML Help Workshop (HHW.EXE) 라는 쏘프트 
웨어가 있어야 한다. HTML Help Workshop 는 HTML 도움말 프로젝트를 구성하는 여 
러 가지 파일 이 나 요소들을 관리 할수 있 다. 그림 16-5 에 HTML Help Workshop 를 보여 
주었다. 



그 B 16-5. HTML Help Workshop 

상황 ID 나 열쇠단어 등의 핵심적 인 개 념은 WinHelp 나 HTML 의 도움말프로젝트에 
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서 같지만 이 요소들을 프로젝트에 포함시 키는 방법 이 다르다. HTML Help Workshop 
에는 조작법에 대한 상세한 직결도움말이 제공되여 있으므로 여기에서는 사용방법에 대 
해 설명하지 않는다. 

HTML 도움말프로젝트는 여러개의 파일로 구성된다. 도움말정보를 보관하고 있는 
HTML 파일，상황의존도움말에 표시되는 문자렬을 보관하고 있는 본문파일, 색인파일 
및 차례파일 등이 다. 색 인과 차례 는 표제 과 도움말정 보를 보관하고 있는 HTML 파일의 
련결을 지 정하여 작성 된다. 

이 러한 파일 ( HTML 파일도 포함)들은 모두 HTML Help Workshop 를 리용하여 작 
성할수 있다. 파일을 관리하는 프로젝트파일의 확장자는 .HHP 이다. 

필 요한 파일들을 작성 하면 그것 을 번 역 하여 CHM 파일을 작성 한다. 이 파일 에 는 프 
로젝트에 정의되여 있는 모든 도움말정보가 보관되여 있다. HtmlHelp () 를 호출할 때 지 
정 하는것 이 이 파일 이 다. HTML Help Workshop 의 편리 한 기능의 하나로 CHM 파일을 
역번역하여 부분품 ( Component ) 단위로 분해하는 기능이 있다. 

HTML Help Workshop 에 는 WinHelp () 의 프로젝 트를 HTML 도움말프로젝 트로 변 
환하는 기능도 있다. 그러 나 두 도움말체계의 차이를 고려하면 처음부터 HTML 도움말 
을 작성하는 편이 쉬울것 이 다. 

HTML 도움말의 작성 에 필요한 파일의 편집 이 나 관리는 HTML Help Workshop 를 
사용하는것이 제일 적합하다. 여기에서는 매 파일들의 내용을 보여 주지 않는다. 

HtmIHelpC ) 

HTML 도움말을 표시 하려 면 HtmlHelD ( ) 를 호출하여 야 한다. 우선 프로그람에 
HTMLHELP . H 라는 머 리 부파일을 포함시 켜 야 한다. HTMLHELP . LIB 도 포함시 켜 야 
한다. HtmIHelpC ) 의 선언을 아래에 준다. 

HWND HtmlHelp(HWND hwnd , LPCSTR filename , UINT command , 

DWORD extra ); 


hwnd 에는 도움말을 기동하는 창문의 손잡이를 지정 한다. filename 에는 표시 하려 고 
하는 도움말파일의 이름을 구동기 이름 및 경 로이름과 함께 지정 한다. 이 파일은 HTML 
도움말파일로서 번역되여 있으며 확장자가 CHM 이여야 한다. 이 파일은 여기에서 지정 
된 등록부안에 존재하여 야 한다. 

command 에는 HtmlHelp ( ) 함수에 보내는 지 령을 설정한다. command 에 설정 할수 
있는 지령들을 아래에 준다. 
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지정 한다. 

HH _ DISPLAY_SEARCH 

HTML 도움말표시기에 [ Find ] 표쪽을 표 
시 한다. 표제 를 filename 파라메 터 에 지 정 
한다. 

HH _ DISPLAY_TOC 

HTML 도움말표시 기 에 [( Contents ] 표쪽 
을 표시 한다. 제 목을 filename 파라메 터 에 
지정 한다. 

HH _ DISPLAY_TOPIC 

지정된 표제를 표시 한다. 표제 파일을 
filename 파라메 터 에 지 정 한다. 

HH HELP CONTEXT 

ID 로 지정된 표제 를 표시한다. 

HHJNITIALIZE 

HTML 도움말을 초기화한다. hwnd 와 
filename 에 NULL 을 설정한다. 프로그람 
의 기 동시 에 한번만 실 행한다. 

HH _ TP _ HELP_CONTEXTMENU 

상 황 의 존 도 움 말 을 표 시 한 다 . WM _ 
CONTEXTMENU 통보문을 처리할 때 사 
용된 다. 튀 여나오기 되 는 통보문을 보관 
한 파일을 filename 파라메 터 에 설정 한다. 
조종체 의 손잡이 를 hwnd 과라메 터 에 설 
정 한다. 

HH _ TP _ HELP _ WM_HELP 

상황의 존도움말을 표시한다. 일 반적 으로 
WM_HELP 통보문을 처리할 때 발송된다. 

튀여 나오기 되 는 통보문을 보관하고 있는 
파일을 filename 파라메 터 에 설정 한다. 조 
종체 의 손잡이 를 hwnd 파라메터 에 설정 
한다. 

HH_UNINITIALIZE 

HTML 도움말의 완료처 리 를 진행한다. 
hwnd 와 filename 에 NULL 을 설정한다. 
프로그람을 완료할 때 사용된다. 


매 지 령 에서 extra 에 설정 하는 값을 아래 에 준다. 


HH _ DISPLAY_INDEX 

열쇠단어로 선택된 표제를 보관하고 있는 문자 
렬의 지시자 

HH _ DISPLAY_SEARCH 

검 색 제 목을 지 정하는 HH _ FTS_QUERY 구조 
체의 지시자 

HH DISPLAY TOC 

선택되는 표제를 보관하고 있는 문자렬의 지시 
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자 또는 NULL 

HH _ DISPLAY_TOPIC 

표시되는 표제를 보관하고 있는 문자렬의 지시 
자 또는 NULL 

HH HELP CONTEXT 

표제 의 상황 ID 

HHJNITIALIZE 

Cookie 라고 하는 값을 받기 위 한 DWORD 형 
의 지시자. 이 Cookie 는 HH_UNINITIALIZE 
를 사용할 때 HtmlHelp ( ) 에 전송된다. 

HH TP HELP CONTEXTMENU 

(본문을 참조) 

HH TP HELP WM HELP 

(본문을 참조) 

HH_UNINITIALIZE 

HHJNITIALIZE 로 얻 은 Cookie 


HH_TP_HELP_WM_HELP 와 HH_TP_HELP_CONTEXTMENU 아 사 는 extra 에 
DWORD 형의 배 렬에 대 한 지시 자를 설정한다. 배 렬에는 두개의 값을 설정한다. 첫번째 
값에 는 조종체 (누름단추, 편집칸 등) 또는 차림 표항목의 ID 를 설정 한다. 두번째 값에 는 
그 조종체 나 차림 표항목과 관련한 도움말정 보의 상황 ID 를 설정한다. 배 럴의 끝에 는 령 
을 두개 배 치한다. 이 두개의 지 령은 상황의존도움말을 지원한다. HtmlHelp ( ) 는 호출 
이 성 공하면 도움말창문의 손잡이 를 돌려 주며 실 패하면 NULL 을 돌려 준다. 


HtmlHelp ( ) 의 filename 파라메 터 의 상세 

대 다수의 지 령 에 서 는 HtmlHelp ( ) 의 filename 파라메 터 에 CHM 파일의 이 름을 설정 
한다. 그러 나 일부 지 령 에서는 이 파라메터 에 어떤 정보를 추가하기도 한다. 추가정보는 
filename 이라는 하나의 문자렬안에서 두개의 점으로 구별되여 설정된다. 실례로 
HH _ DISPLAY_TOC 의 경 우 filename 에 표시 되 는 CHM 파일과 함께 HTML 파일의 이 
틈이 문자렬에 설정된다. 이 경우에 아래의 구문을 사용한다. 


chm - filename :: html-filename 


아래 에 보여 주는 HtmlHelp () 악 호출에서 는 CHM 파일 이 helptest.chm 이며 표제 
가 lis 代) ox.htm 으로 된 다. 

HtmlHelp(hwnd, <f c ： \\helptest. chm ： : /listbox, htm", HH_DISPLAY_TOC, 0 )； 

CHM 파일만아는 도움말프로젝 트를 구성하는 파일 들이 보관되 여 있 었 던것 과 꼭 같은 
등록부구조가 들어 있다. 그러므로 실례로 listbox.htm 이 새끼등록부의 안에 보관되여 
있었다면 그의 경로를 지정해 줄 필요가 있다. 

HH _ TP_CONTEXTMENU 또는 HH _ TP _ HELP _ WM_HELP 지 령 을 사용하는 경 우에 
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는 튀 여 나오기 되 는 본문을 보관하는 문자렬 을 filename 파라메 터 에 설정 한다. 례 하면 
HTML 도움말의 실례 프로그람에서 는 아래 와 같은 코드를 사용하여 조종체의 도움말정 보 
를 튀 여 나오기시키고 있다. 튀 여 나오기되는 본문은 htpopups.txt 라는 파일에 보관되여 
있 다. 

// 조종체와 관련한 상황도움말 
HtmlHelpC (HWND) wParam, 

“C : \\ helptest. chm :: htpopups. txt” , 

HH_TP_HELP_CONTEXTMENU, (DWORD) HelpArray); 

튀여 나오기 되 는 본문은 아래 와 같은 형 식 으로 설 정한다. 

. topic ID 
popup text 


ID 는 표제 의 상황 ID 이 다. 표시 하려 는 통보문은 popup text 에서 지정 한다. 실례 로 
HTML 도움말의 실례프로그람에서 리용되는 파일의 맨 앞부분은 아래와 같다. 


.topic IDH.PB0 
This is the popup 
.topic IDH.PBl 
This is the popup 
.topic IDH_PB2 
This is the popup 
.topic IDH_PB3 
This is the popup 


for the main window push button, 
for the first push button, 
for the second push button, 
for the third push button. 


여기에서는 구체적인 수값이 아니라 프로그람에서 정의한 마크로를 리용하고 있다는 
데 주의를 돌려 야 한다. 그것은 HTML Help Workshop 에서는 도움말프로젝트에 표준 
의 C 八>+머리부파일을 포함시킬수 있기때문이다. 

filename 파라메터 는 도움말의 2 차 창문을 지 정 하는데 도 사용된 다. 그러 자면 우선 
HTML Help Workshop 의 [Add/Modify window definition] 추가선택 항목을 사용하 
여 창문을 작성 한다. 2 차 창문을 사용하기 위해서는 다음의 서식으로 filename 파라메터 
에 창문이름을 설정한다. 


chm - filename»windowname 
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HTML 도움말실례 프로그람에서 는 아래의 코드로 small win 이라는 이름의 2 차 창문 
에 [Dialog] 차림표의 도움말정보를 표시하고 있다. 

HtmlHelp ( hwnd, “c:\\helptest.chm»smallwm”, 

HH_HELP_CONTEXT, (DWORD) IDH_MENUDLG); 


HtmlHelp 의 실례 

아래의 프로그람은 WinHelp( ) 의 실례프로그람을 개조한것이다. 두 도움말체계는 
갈은 통보문을 처리하고 있으며 세부적처리는 거의 갈으므로 변경이 필요한 부분은 많지 
않다. 변경하는 내용은 다음과 같다. 

* 머 리부파일 HTMLHELP. H 를 포함시 킨다. 

• WinHelpC ) 의 호출을 HtmlHelp ( ) 의 호출로 변경한다. 

물론 HTML Help Workshop 를 사용하여 HTML 파일 자체 도 작성 해 야 한다. 
Htmlhelp( ) 의 실례프로그람의 프로그람 코드를 실례 16-3 에 주었다. 이 프로그람을 실 
행 하기 에 앞서 이 책 의 부속 CD-ROM 에 수록되 여 있는 HELPTEST.CHM 을 C 구동기 
의 뿌리등록부에 복사하여 놓아야 한다. 왜 냐하면 이 프로그람에서는 도움말파일의 경로 
를 고정하여 놓았기때문이다.(물론 이 경로이름을 변경하여도 상관없다.) 
HTMLHELP. LIB 도 련결하여야 한다. 프로그람의 실행결과를 그림 16_6 에 주었다. 


실 례 16-3. HtailHelp 프로그람 


HtmlHelp (hwnd, “C:\\helptest. chm»smallwin ”， 


}； 


HH_HELP_CONTEXT, 


char lbstring [6] [40] = { 
"one", "two", "three", 
"four", "five", "six" 


}； 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 
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WNDCLASSEX wcl ； 

HACCEL hAccel ； 

// 창문물라스를 정의 한다 . 

wcl. cbSize = sizeof (WNDCLASSEX) : 


wcl.Mnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문콜라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이 콘 

wcl. hlconSm = NULL ； // 큰 아이론의 축소판을 사용한다 . 

wcl. hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl. IpszMenuName = "HelpDemoMenu" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject (WHITE_BRUSH) ; 

// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindowEx ( 

WS_EX_CONTEXTHELP, // [ ? ] 단추를 표시 한다 . 
szWinName, // 창문믈라스의 이름 
"HTML Help Demonstration", // 제목 
WS_SYSMENU | WS_SIZEBOX, 

CWJJSEDEFAULT, // X 자리 표는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 높이 는 Windows 가 결 정 하게 한다 . 
NULL, // 어미창문은 없다 . 
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NULL, 

hThisInst, 

NULL 


// 클라스차림 표의 덧쓰기는 하지 않는다 . 
// 실체의 손잡이 
// 추가파라메터 는 없 다 . 


hlnst = hThisInst ； // 현재의 실체손잡이를 보관한다 . 

// 건반가속기를 적재한다 . 

hAccel = Load Accelerators (hThisInst, "HelpDemoMenu") ； 

// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode) ； 

UpdateWindow (hwnd); 

// 통보문순환고리를 작성 한다 . 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

if (! Translate Accelerator (hwnd, hAccel, &msg)) { 
TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage(&msg) ； // Windows 2000 에 조종을 넘 긴다 . 


return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 


WPARAM wParam, LPARAM IParam) 


{ 

int response; 

static DWORD cookie = 0 ； 

switch (message) { 
case WM.CREATE ： 

// HTML 도움말을 초기화한다 . 

HtmlHelp(NULL, NULL, HH_INITIALIZE, (DWORD) &cookie); 
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// 조종체 (새끼 창문)를 작성 한다 . 

CreateWindowC 

” BUTTON”, // 조종체의 들라스이름 
"Main Window PB", // 제 목 

BS_PUSHBUTTON | WS.CHILD | WS.VISIBLE, // 누름단추 

10, 60, 120, 30, 

hwnd, // 어미는 기본창문이다 . 

(HMENU) ID_PB0, // 조종체의 ID 
hlnst, // 프로그람의 실체의 손잡이 
NULL // 추가파라메 터는 없다 . 

); 

break ； 

case WM.HELP ： // 사용자가 [F1] 건을 눌렀든가 [ ? ] 단추를 사용했다 . 
if(((LPHELPINFO) IParam) -MContextType == 

HELPINFO.MENUITEM) { 

// 차림표와 관련한 도움말요청 
switch (((LPHELPINFO) IParam)->iCtrlId) { 
case IDM_DIALOG: 

HtmlHelp (hwnd, "c: \\ helptest. chm>smallwin n , 
HH_HELP_CONTEXT, 

(DWORD) IDH 一 MENUDLG); 

break ； 

case IDM.HELP ： 

HtmlHelp(hwnd, "c:\\helptest.chm>smallwin M , 
HH_HELP_CONTEXT, 

(DWORD) IDH.MENUHELP) ； 

break; 

case IDM.HELPTHIS ： 

HtmlHelp(hwnd, "c:\\helptest.chm>smallwin”, 
HH_HELP_CONTEXT, 

(DWORD) IDH_MENUABOUT); 

break ； 

case IDM.EXIT ： 

HtmlHelp(hwnd, "c:\\helptest. chm>smallwin n , 
HH_HELP_CONTEXT, 

(DWORD) IDH 一 MENUEXIT); 
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default ： 

// 차림표띠가 선택되였으나 반전표시된 항목이 없다 . 
HtmlHelpChwnd, "c ： \\helptest.chm>smallwin”, 
HH_HELP_CONTEXT, 

(DWORD) IDH_MENUMAIN); 

} 

} 

else 

if(((LPHELPINFO) IParam) - >hItemHandle != hwnd) { 

// 조종체와 관련한 상황도움말 

HtmlHelp((HWND) ((LPHELPINFO) IParam) ->hItemHandle, 

"c : \\ helptest. chm :: htpopups. txt ’’, 
HH_TP_HELP_WM_HELP, (DWORD) HelpArray) ； 

} 

else { 

// 기본창문의 표준도움말 

HtmlHelp(hwnd, "c:\\helptest. chm>smallwirT, 
HH_HELP_CONTEXT, IDH_MAIN) ； 

} 

break ； 

case WM.CONTEXTMENU : // 사용자가 마우스의 오른쪽 단추를 찰칵했다 . 
if((HWND) wParam != hwnd) 

// 조종체와 관련한 상황도움말 
HtmlHelp ((HWND) wParam, 

’’ c : \\ helptest. chm :: htpopups .txt", 
HH_TP_HELP_CONTEXTMENU, (DWORD) HelpArray); 

else 

// 기본창문과 관련한 상황도움말 
HtmlHelp (hwnd, "c* \\ helptest. chm>smallwin n , 
HH_HELP_CONTEXT, IDH.MAIN) : 

break ； 

case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM—DIALOG: 

DialogBox (hlnst, ” HelpDemoDB ” , 

hwnd, (DLGPROC) DialogFunc); 

break ； 

case IDM.HELP ： // 차림표로부터 도움말이 선택되였다 . 
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HtmlHelp (hwnd, 

’’ c : \\ helptest. chm :: /helptest. htm", 

HH_DISPLAY_TOC, 0); 

break ； 

case IDM.HELPTHIS ： 

MessageBox(hwnd, ” HTML Help Sample Program VI.0", 

"About”, MB_OK); 

break ； 

case IDM_EXIT: 

response = MessageBox (hwnd, "Quit the Program? M , 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQu 仕 Message (0); 
break ； 

} 

break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

HtmlHelp (NULL, NULL, HHJJNINITIALIZE, cookie) ； // HTML 도움말을 닫는다 . 
PostQuitMessage (0); 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보 문은 
Windows 2000 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, lParam); 

} 

return 0 ； 

} 

// 실례프로그람의 대화함수 

BOOL CALLBACK DialogFunc (HWND hdwnd, UINT message, 

WPARAM wParam, LPARAM lParam) 

{ 

int i ； 


switch (message) { 

case WM.HELP ： // 사용자가 [FI] 건을 눌렀든가 [ ? ] 단추를 사용했다 . 
// 조종체와 관련한 상황도움말 

HtmlHelp ((HWND) ((LPHELPINFO) lParam) ->hItemHandle, 

"c: \\ helptest. chm :: htpopups. txt", 
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HH_TP_HELP_WM_HELP, 

(DWORD) HelpArray) ； 

return 1 ； 

case WM.CONTEXTMENU : // 사용자가 마우스의 오른쪽 단추를 찰칵했다 . 

if((HWND) wParam != hdwnd) 

// 조종체와 관련한 상황도움말 
HtmlHelp((HWND) wParam, 

" c : \\ helptest. chm :: htpopups. txt ”, 
HH_TP_HELP_CONTEXTMENU, (DWORD) HelpArray) ； 

else 

// 대화함수와 관련한 상황도움말 
HtmlHelp(hdwnd, "c :\\ helptest. chm>smallwin M , 
HH_HELP_CONTEXT, 

(DWORD) IDH.DLG) ； 

return 1 ； 

case WM.COMMAND ： 

switch (LOWORD (wParam)) { 
case IDCANCEL ： 

EndDialog (hdwnd, 0); 

return 1 ； 
case IDD_PB1 ： 

MessageBox (hdwnd, "Push Bu 竹 on 1”, 

"Button Press”, MB_OK) ； 

return 1 ； 
case IDD_PB2: 

MessageBox (hdwnd, ” Push Button 2", 

"Button Press", MB.OK) ； 

return 1 ； 
case IDD_PB3: 

MessageBox (hdwnd, "Push Button 3”, 

"Button Press”, MB_OK) ； 

return 1 ； 

} 

break ； 

case WM.INITDIALOG ： // 목록칸을 초기화한다 . 

for(i=0 ； KNUMSTRINGS ； i++) 

SendDlgltemMessage (hdwnd, IDD_LB1, 

LB.ADDSTRING, 0, (LPARAM) lbstring [i]) ； 
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return 1 ； 

} 

return 0 ； 

} 



그림 16-6. HTML 도음말실 례프로그람의 실행결과 

자체로 해보기 


도움말의 기능가운데서 프로그람작성자들이 절실히 요구하는 기능의 하나가 련습카 
드이 다. 련습카드는 사용자에게 조작과 관련한 설명 을 제 공하기 위하여 사용된다. 례 하 
면 문서 편집 기 에서 단락을 설정하거 나 인쇄방법 등을 선택하는 방법 을 한걸음씩 설명하 
는데 련습카드를 사용할수 있다. 

다음 WinHelp 도움말의 프로젝 트에 서 HelP_PARTIALKEY 과는 열쇠 단어 검 색 추가선 
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제 16 장. 두 종류의 도움말체계 


택항목을 사용해 볼수 있다. 편집칸을 표시 하고 사용자에게 검색할 도움말정보의 열쇠단 
어를 입력시키고 그것과 부분적으로 일치하는 모든 표제들을 검색할수 있다. 

HTML 도움말프로젝트에 검색기능도 추가해 볼수 있다. 

마지 막으로 한가지 보충해 둘것 이 있다. 그것 은 직 결된 상황의존도움말이 모든 
Windows 2000 응용프로그람에 있어서 중요한 구성요소이므로 후에 추가할것이 아니라 
프로그람의 작성 을 개시하는 시점 에서 도움말지 원기능을 고려해 야 한다는것 이 다. 
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인쇄기의 사용법 


Windows 2000 은 비 트매 프，특수한 문자서 체 와 다양한 도형 들을 광범히 리 
용하는 도형 적 인 조작체 계 이 다. 그러 므로 처 음 Windows 2000 프로그람을 작성 해 
보는 사람들은 인쇄기능을 실현하려면 복잡하고 어려운 처리를 해야 하지 않겠는 
가고 생각할수 있다. 그러나 실제는 그렇지 않다. 

Windows 2000 에 있어서 인쇄는 DOS 에 비하면 확실히 복잡한것이지만 
Windows 2000 에 는 고급한 인쇄 를 실 현 하는 기 능이 미 리 갖추어 져 있다. 
Windows 2000 은 인쇄기를 조종하는 대 부분의 기 능을 제 공하여 준다. 알아 두어 
야 할것은 많을수도 있지만 인쇄를 진행하는것 그자체는 결코 어렵지 않다. 기본 
적 인 기술만 정통하면 모든 웅용프로그람에 인쇄기능을 쉽게 추가할수 있다. 

이 장에서는 다음의 기능을 실현하는 방법에 대해 설명한다. 

• 본문인쇄 

• 도형인쇄 

• 도형의 척도설정 

• 인쇄중지함수의 작성과 사용법 

이것들은 Windows 2000 의 모든 인쇄기능의 기초로 된다. 설명을 하기 에 앞 
서 한가지 알아 두어야 할것 이 있다. 그것은 어떤 자료를 인쇄기에 출력하는 경 
우에 그것 이 인쇄 기 자체 가 아니 라 실제 로는 인쇄 완충기 (Printer Spooler ) 에 전 
송된다는것이다. 이것은 프로그람작성방법에 직접 영향을 미치지는 않지만 알아 
두어야 한다. 
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인쇄기장치상황의 얻기 


화면 장치 상황 ( DC ) 이 화면 에 로의 출력 을 관리 하는것 과 마찬가지 로 인쇄 기에 로의 출 
력은 인쇄기장치상 m 今 의해 관리된다. 그러므로 인쇄기에 출력하기에 앞서 인쇄기의 장 
치상황을 얻어야 한다. 

인쇄기 장치 상황을 얻는데는 여러가지 방법이 있 다. 여기에서는 CreateDC( ) 말 
PrintDlgExC )를 사용하는 방법을 설명한다. CreateDCC ) 는 사용자의 설정을 받지 않고 
장치상황을 얻는다. PrintDlgEx ( ) 는 공통대화칸을 표시하고 사용자에게 인쇄기장치상황 
의 설정을 진행하게 한다. 매 함수들의 사용방법을 설명해 보자. 

CreateDC( ) 

인쇄 기 장치상황을 얻기 위 한 첫 번째 방법 은 CreateDC( ) 를 사용하는것 이 다. 아래 에 
선언을 보여 주었다. 


HDC CreateDC(LPCSTR IpszWhat , LPCSTR DevName , 
LPCSTR NotUsed , 

CONST DEVMODE * DevMode ); 


IpszWhat 에 “ DISPLAY 1 ’ (화면구동기를 얻는 경우) 또는 “ WINSPOOL ” (인쇄기구동 
프로그람을 얻 는 경 우) 라는 문자렬지 시 자를 설정 한다. 인쇄 를 진행하는 경 우 IpszWhat 
에 “ WINSPOOL ” 을 설정한다. DevName 에 인쇄 기이 름을 설정한다. NotUsed 에 는 
NULL 을 설 정한다. 

CreateDC( ) 는 호출이 성 공하면 장치상황의 손잡이를 돌려 주며 실패 하면 NULL 을 
돌려 준다. 응용프로그람에서 인쇄 처 리를 완료하면 DeleteDC( ) 를 호출하여 인쇄 기 장치 
상황을 삭제해 야 한다. 

응용프로그람에서 현재 선택되여 있는 인쇄기의 이름을 얻어야 하는 경우도 있다. 
그러 자면 EnumPrinter( ) 를 사용하여 사용가능한 인쇄 기 의 이 름을 렬 거 시 킨다. 

CreateDCC ) 는 사용자의 설정을 받지 않고 인쇄를 진행할 때 자주 사용되는 함수이 
다. 사용자에게 인쇄설정을 시키지 않는것은 일반적인것이 못될지도 모르지만 드문히 그 
런 정황이 조성된다. 례하면 사용자가 없을 때 체계리력기록을 인쇄하는 경우 등이 다. 
그러나 대부분의 경우(이 장의 실례에서도 갈다.) 인쇄기장치상황을 엄는데는 
PrintDlgEx( )A 사용된 다 . 

PrintDlgEx( ) 

인쇄 기 장치 상황을 얻 기 위 한 두번째 방법 은 PrintDlgEx( ) 를 사용하는것 이 다. 
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PrintDlgExC ) 는 인쇄공통대화칸을 표시하고 사용자가 여러가지 추가선택항목들을 설정 
하게 한다. PrintDlgEx () 는 Windows 2000 에 새 로 추가된것 으로서 이전의 PrintDlg () 
를 치환한것 이다. 

파라메터를 설정하면 인쇄대화칸의 형태를 변경시킬수도 있지만 기본적으로는 그림 
17-1 에 표시한 형태로 된다. 



그림 17-1. Windows 2000인쇄기특성 S 

이 그림에서 알수 있는바와 같이 PrintDlgEx ( ) 는 사용자가 인쇄기를 설정하는 특 
성표를 제공한다. 결국 PrintDlgExC )를 사용하여 장치상황을 엄는 방법을 사용하면 그 
와 동시에 사용자가 인쇄설정을 하도록 할수 있다. 

PrintDlgExC ) 는 강력하면서도 유연한 기능을 제공한다. 먼저 PrintDlgExC ) 의 기 
본적인 사용법 을 설 명 한다. 


Windows 2000 으 I 새로운 기능 : PrintDlgExC ) 함수는 종전의 PrintDlg ( ) 함수를 치환 
한것이다. PrintDlgExC ) 가 보다 강력하며 유연한 기능을 계공해 준다. 그러므로 새로운 
응용프로그람들에서는 PrintDlgEx ( ) 를 사용해야 한다. 

PrintDlgEx ( ) 선모은 다음과 같다. 


BOOL PrintDlgEx (LPPRINTDLGEX printDlgEx ) : 

PrintDlgExC ) 는 사용자가 [ Print ] 단추를 눌러 (인쇄 를 실행 하는 경 우) 대 화칸을 닫 
으면 S_OK 를 돌려 준다. PrintDlgExC )1- 사용하려 면 COMMDLG.H 를 포함시 켜 야 한 
다. 이 머 리부파일은 보통 WINDOWS . H 를 포함시키면 자동적으로 포함된다. 그러 나 
리용하는 번역프로그람이 어떤 리유로 COMMDLG.H 를 자동적으로 포함하지 않는 경우 
에는 이 지정을 추가하여야 한다. 
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역시 printDlgExO 는 새로운 함수이므로 프로그람코드의 선두에 竹® VKEK 마크로에 
0 x 0500 을 정의하여 머 리부파일의 적절한 정 보가 포함되도록 해 야 한다. 

PrintDlgEx 파라메 터 가 가리 키 는 PRINTDLGEX 구조체 의 내 용은 PrintDlgExC ) 함 
수의 조작을 설정 하는것이다. PRINTDLGEX 극■조 A 꺅 정의를 아래에 보여 주었다. 

typedef struct tagPDEX { 

DWORD IStructSize ； 

HWND hwndOwner ； 

HGLOBAL hDevMode ； 

HGLOBAL hDevName ； 

HDC hDC ； 

DWORD Flags ； 

DWORD Flags2 ； 

DWORD ExclusionFlags ； 

DWORD nPageRanges ； 

DWORD nMaxPageRanges; 

LPPRINTPAGERANGE IpPageRanges ； 

DWORD nMinPage ； 

DWORD nMaxPage ； 

DWORD nCopies; 

HINSTANCE hlnstance ； 

LPCSTR IpPrintTemplateName ； 

LPUNKNOWN lpCallback ； 

DWORD nPropertyPages ； 

HPROPSHEETPAGE *lphPropertyPages ； 

DWORD nStartPage; 

DWORD dwResultAction ； 

} PRINTDLGEX ； 

IStructSize 에 PRINTDLGEX 구조 체 의 크기 를 설 정 한 다 . hwndOwner 에 
PrintDlgExC ) 의 어 미 창 문의 손 잡 이 를 설 정 한 다 . hDevMode 에 는 대 역 변 수 인 
띠/ M 幻 C 幻:구조체의 손잡이를 설정한다. 이 파라메터 에는 함수를 호출하기전에는 대화 
칸의 초기화정보가 설정되며 함수를 호출한후에는 매 조종체들의 상태가 보관된다. 

hDevMode 에 NULL 을 설 정 할수도 있다. 이 경 우에 는 PrintDlgEx ( ) 가 
DEVMODE 구조체의 작성과 초기화를 진행하고 그의 손잡이를 hDevMode 성원에 돌려 
준다. DEVMODE 구조체는 이 장의 실례프로그람에서는 리용하지 않는다. 

hDevNames 에 는 대 역 변수인 DEVNAMES 구조체 의 손잡이 를 설정 한다. 이 구조체 
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는 인쇄기구동프로그람의 이름，인쇄기의 이름 및 인쇄기포구의 이름을 정의한다. 이 이 
름들은 PrintDlgExC ) 의 대화칸을 초기화하는데 사용된다. 함수를 호출한후에는 이 성 
원들에 사용자에 의 하여 선택된 이 름들이 설정된다. hDevNames 에 NULL 을 설정 할수 
도 있 다. 이 경 우에 는 PrintDlgEx ( ) 가 Z 班구조체 의 작성 과 초기 화를 진행 하 
며 그의 손잡이 를 hDevNames 에 돌려 준다. 

必표 FA 的 AffiS ■ 구조체는 이 장의 실례 프로그람에서 는 쓰이지 않는다. hDevNames 와 
hDevMode 에 모두 령을 설정 하면 체계설정의 인쇄기가 사용된다. 

함수를 호출한후에는 Flags 성원에 지정된 값에 따라서 hDC 에 인쇄기장치상황 또는 
정 보상황의 어 느 하나가 돌려 진다. 이 장에 서 는 hDC 에 인쇄 기장치 상황이 돌려 지 게 
하였 다. (장보상身이 란 장치 상황의 작성 을 진행 하지 않고 그 정 보만을 보관한것 이 다. ) 
nPageRanges 와 IpPageRanges 를 사용하여 페지범위를 설정한다. 돌림 값으로서 
nPageRanges 에 는 사용자에 의 해 선택된 패 지 범 위 가 보관된다. 한폐 지 이 상의 범 위 를 
선택할수 있다. 만일 대화칸에서 폐지범위의 설정을 비표시상태로 하려면 Flags 성원에 
PD_NOPAGENUMS 를 포함시 킨다. 

nMaxPageRanges 에 IpPageRanges 가 가리키는 배 렬의 길이를 설정한다. Flags 에 
PD_NOPAGENUMS 가 포함되 여 있는 경 우에 는 이 파라메 터 가 무시 된다. 

IpPageRanges 에 는 PRINTPAGERANGE 구조///배 렬 의 지 시 자 를 설 정 한 다 . 
PRINTPAGERANGE 구조체의 정의를 아래에 표시한다. 


typedef struct tagPRINTPAGERANGE { 

DWORD nFromPage ； // 개시폐지 

DWORD nToPage ； // 완료폐지 

} PRINTPAGERANGE; 

Flags 에 PD_NOPAGENUMS 가 포함되 여 있는 경 우는 IpPageRange 가 무시 된 다. 
nMinPage 에는 대화칸에서 지정할수 있는 최소폐지번호를 설정하며 nMaxPage 에 
는 대 화칸에서 지정 할수 있는 최 대폐 지번호를 설정 한다. Flags 에 PD_NOPAGENUMS 
가 포함되여 있는 경우는 이 성원들이 무시된다. 

nCopies 에 대 화칸의 [Number of copies ] 라는 편집 칸에 표시되는 초기값을 설정 한 
다. 함수를 호출한후는 사용자에 의해 지정된 인쇄부수가 nCopies 에 보관된다. 응용프 
로그람은 사용자에게 요구되는 인쇄부수에 따라 실제적 인 인쇄를 진행한다. 

인쇄특성표로 다른 도안(대화칸본보기)을 사용할수도 있다. 그러자면 hlnstance 에 
대 체 대 화 칸 본 보 기 의 실 체 손 잡 이 를 설 정 하 고 Flags 에 PD_ENABLEPRINT 
TEMPLATEHANDLE 을 포함시킨다. 대체 대화칸을 사용하지 않으려 는 경우에는 
hlnstance 에 NULL 을 설정 한다. 

IpPrintTemplateName 에 대 화칸본보기 의 자원 이 름을 설 정하여도 대체 대 화칸을 사용 
할수 있 다. 이 경 우에 는 hlnstance 에 대 화칸을 포함한 모둘의 실 체 손잡이 를 설정 한다. 
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Flags 에 PD_ENABLEPRINTTEMPLATE 가 포함되여 있지 않은 경우에는 
IpPrintTemplateName 이 무시 된 다. 

lpCallback 에는 역호출정보를 얻기 위한 역호출함수와 지시자를 설정한다. 이러한 
정보가 필요 없는 경우에는 lpCallback 에 NULL 을 설정 한다. 이 장의 실례 프로그람에 
서는 역호출정보를 사용하지 않는다. 

nPropertyPages 에는 lphPropertyPages 가 가리키는 배렬의 길이를 설정한다. 이 
배 럴은 인쇄특성표조종체 에 추가되 는 보조특성표의 손잡이 를 보관하는것 이 다. 보조특성 
표가 필요 없는 경우에는 (보통 필요 없다.) nPropertyPages 에 령을 설정 하며 
lphPropertyPages 에 는 NULL 을 설정 한다. 

nStartPage 에는 인쇄특성표가 능동상태로 되였을 때 제일 처음 표시될 폐지를 설정 
한 다 . 일 반적 인 프 로 그 람 들 에 서 는 이 값 을 START _ PAGE_GENERAL 로 한 다 . 
PrintDlgEx ( ) 의 호출이 성공하면 그의 조작결과가 dwResultAction 에 돌려 진다. 
dwResultAc 社 on 은 아래의 어느 한 값으로 된다. 


PD _ RESULT_APPLY 

사용자는 [ Apply ] 단추를 눌렀으나 [ Print ] 단추는 
누르지 않고 있다. 응용프로그람은 인쇄를 실행하지 
않는다. 

PD _ RESULT_CANCEL 

사용자는 [ Cancel ] 단추를 눌렀다. 응용프로그람은 
인쇄를 실행하지 않는다. 

PD _ RESULT_PRINT 

사용자는 [ Print ] 단추를 눌렀 다. 응용프로그람은 
인쇄를 실행한다. 


PrintDlgExC ) 의 호출이 실패한 경우에는 dwResult Action 에 유효한 값이 보관되 
지 않는다. 

Flags 에는 인쇄특성표의 형태나 능동으로 하려는 조종체의 종류를 설정한다. 돌림 
값으로서 Flags 에 사용자의 조작내용이 돌려 진다. Flags 에 설정되거나 보관되는 값은 
표 17-1 에 표시한 값들의 조합으로 된 다. 


표 17-1. PRINTDLGEX 구조체 의 Flag 성 원의 값 


PD_ALLPAGES 


[ All ] 단일선 택단추를 선 택 상태 로 한 
다.(이 것 은 체 계설정 이 다.) 돌림값인 경 
우 [ All ] 단일선택단추가 선택 되 여 있 다는 
것 을 가리킨 다. 
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PD_COLLATE 

[Collate] 검사칸을 선택상태로 한다 . 돌 
림값인 경우 [Collate] 검사칸이 선택되며 
선택된 인쇄기가 부단위의 인쇄를 지원하 
지 않고 있다는것을 표시 
이 경우에는 프로그람에서 부단위의 인 
쇄를 처리하여 야 한다 . 

PD_CURRENTPAGE 

돌림 값으로서 [Current page] 단일 선택 
단추가 선택되여 있다는것을 표시 

PD DISABLEPRINTTOFILE 

[Print to file] 검사칸을 무효로 한다 . 

PD_ENABLEPRINTTEMPLATE 

IpPrintTemplateName 으로 지정된 대체 
대화칸본보기를 사용한다 . 

PD_ENABLEPRINTTEMPLATE 

HANDLE 

hlnstance 로 지정된 대 체대화칸본보기 
를 사용한다 . 

PD_EXCLUSIONFLAGS 

ExclusionFlags 에 자료가 보관되여 있 
다는것을 표시 

PD HIDEPRINTTOFILE 

[Print to file] 검사칸을 비 표시 로 한다 . 

PD_NOCURRENTPAGE 

[Current page] 단일 선택 단추를 비 표시 
로 한다 . 

PD—NOPAGENUMS 

i[Pages] 단일선택단추를 무효로 한다 . 

PD NOSELECTION 

[Selection] 단일선택단추를 무효로 한다 . 

PD—NOWARNING 

경고통보문을 표시하지 않게 한다 . 

PD—PAGENUMS 

[Pages] 단일 선택 단추를 선택 상태 로 한 
다 . 돌림 값인 경 우 [Pages] 단일선택단추 
가 선택되여 있다는것을 표시한다 . 

PD_PRINTTOFILE 

[Print to file] 검사칸을 선택상태로 한 
다 . 돌림값인 경우 [Print to file] 검사칸 
이 선택되여 있다는것을 표시 

PD RETURNDC 

hDC 에 장치 상황을 얻 는다 . 

PD_RETURNDEFAULT 

돌 림 값 으 로 서 hDevMode 와 

hDevNames 에 체계설정의 인쇄기가 보관 
된 다 . 대화 칸은 표시되지 않 는다 . 
PrintDlgExC )를 호출할 때 hDevMode 
와 hDevNames 에 NULL 을 설 정 한다 . 

PD RETURNIC 

KDC 에 정 보상황을 얻 는다 . 

PD_SELECTION 

tSelection] 단일선택 단추를 선택상태로 
한다 . 돌림값의 경우 [Selec 吐 on] 단일선택 
단추가 선택되여 있다는것을 표시한다 . 
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PD_USEDEVMODECOPIESAND 

COLLATE 

PD_USEDEVMODECOPIES 

[Number of Copies ] 돌 리 개 조 종 체 및 
[ Collate ] 검사칸을 인쇄기의 기능에 따라 
무효로 한다. 이 기발들을 포함시키지 않 
은 경우는 인쇄부수가 nCopies 성원에 보 
관되며 부단위의 인쇄가 요구되였다면 
PD COLLATE 기 발이 설정 된 다. 

PD_USELARGETEMPLATE 

큰 본보기를 사용한다. 


Flags 2 는 사용할수 없으며 령 을 설정 하여 야 한다. ExclusionFlags 는 항목의 중복을 
피하기 위하여 사용된다. 이것은 특수한 상황에서만 필요하게 된다. 보통 령을 설정한다. 
이미 설명한바와 같이 돌림값으로서 hDC 에 인쇄기장치상황이 돌려 진다. 이것을 사용 
하면 장치 상황을 조작하는 TextOut ( M BitBlt ( ) 등의 함수에 서 인쇄 기 에 로의 출력 이 
진행된다. 응용프로그람에서 인쇄처리가 완료되면 DeleteDC ( )를 호출하여 인쇄기장치 
상황을 삭제한다. 


인쇄 기 함수 


인쇄를 할 때는 몇 가지 인쇄 기함수를 사용해 야 한다. 아래 에 선언들을 보여 주었다. 

int EndDocCHDC hPrDC ); 
int EndPage(HDC hPrDC ); 

int StartDocCHDC hPrDC , CONST DOCINFO * Info ); 
int StartPage (HDC hPrDC ); 

모든 인쇄 기 함수에서 hPrDC 에는 인쇄 기의 장치상황의 손잡이를 설정 한다. 이 함수 
들은 호출이 성공하면 정의값을 돌려 주며 실패하면 부의값을 돌려 준다. 

인쇄 를 시 작하자면 먼저 Stam ) oc () 를 호출하여 야 한다. StartDoc ( ) 는 두가지 처 
리를 진행 한다. 첫번째 처 리는 인쇄 일감 (Print job ) 을 개시 하는것 이 다. 두번째 처 리는 
일감 ID 를 돌려 주는것 이 다. 

이 장의 실례 프로그람은 인쇄 일감 ID 를 필요로 하지 않지 만 인쇄 와 관련된 기 타 함 
수들중에 는 일감 ID 를 필요로 하는것 들도 있 다. Info 파라메터 는 公幻 CZZVF 幻구조체 에 대 
한 지시 자이다. DOCINFO 구도錢와 정의는 다음과 같다. 

typedef struct _DOCINFO { 
int cbSize ； 
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LPCSTR IpszDocName ； 

LPCSTR IpszOutput ； 

LPCSTR IpszDatatype ； 

DWORD fwType ； 

} DOCINFO; 

cbSize 에는 DOCINFO 구조체의 크기를 설정 한다. IpszDocName 에는 인쇄 일감의 
이 름을 설정 한다. IpszOutput 에 는 인쇄 출력 을 받아 들이 는 파일 이 름을 설정한다. 그러 
나 hPrDC 가 가리키는 인쇄기장치상황에 출력하는 경우에는 IpszOutput 에 NULL 을 설 
정 하여 야 한다. IpszDatatype 에 는 인쇄 일 감을 기 록하는데 사용되 는 자료형 을 설정 한다. 
이 성원에 NULL 을 설정할수도 있다. fwType 에는 보통 령을 설정한다. 

한 페지 의 인쇄 를 시 작할 때 마다 StartPage ( ) 를 호출하여 야 한다. 매 폐지의 인쇄 
가 끝나면 EndPage ( ) 를 호출하여 야 한다. EndPage ( ) 는 인쇄 기 에 폐지 바꾸기 처 리를 
진행하게 한다. 모든 인쇄처리가 끝나면 EndDoc ( )를 호출하여야 한다. 그러므로 한개 
페지를 인쇄하는 처리순차는 다음과 같다. 

StartDoc ( dc , & info ) ； 

StartPage ( dc ) ； 

// 여기에서 자료를 인쇄한다. 

EndPage ( dc ) ； 

EndDoc ( dc ) ； 


이식과 관련한 요점 / 16 bit 의 Windows 3.1 에서 는 StartDoc ( 人 StartPage ( 人 
EndPageC ) 및 EndDoc ( ) 의 기능이 탈출코드에 의해 실현되고 있었다. 탈출코드는 
Escape () 함수를 호출하여 보낸다. 닭은 프로그람을 이식하는 경우 Escape () 함수를 _호 
출하는 부분을 해당한 인쇄기 함수로 바꾸어야 한다. 


간단한 인쇄실례프로그람 


Windows 2000 에서 인쇄처 리를 원만히 진행 하려면 아직도 많은 지식을 알아 두어 야 
한다. 그러나 본문의 인쇄는 앞절에서 설명한 기능들을 사용해도 충분히 실현할수 있다. 
그러므로 우선 본문을 인쇄하는 간단한 실례프로그람을 작성해 보기로 한다. 실례 17-1 
의 프로그람은 인쇄기로 여러행의 본문을 인쇄한다. 


652 


교육성 프로그람교육쎈터 




제 17 장. 인쇄기의 사용법 


실례 17-1. Print 프로그람 
// 간단한 인쇄실례 

// 이 정의가 필요한 번역프로그람도 있다. 
ttdefine WINVER 0x0500 


ttinclude 〈 windows. h> 
^include <cstring> 
ttinclude "print, h” 

ttdefine NUMLINES 20 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
void Printlnit (PRINTDLGEX *printdlgex, HWND hwnd) ； 


char szWinNameG = n MyWin”; // 창문들라스의 이름 

int X = 0, Y = 0; // 현재의 출력위 치 
int maxX, maxY； // 화면의 크기 

HDC memDC； // 가상장치손잡이 
HBITMAP hBit； // 비트매프의 손잡이 
HBRUSH hBrush； // 붓의 손잡이 


PRINTDLGEX printdlgex ； 
DOCINFO docinfo ； 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HACCEL hAccel; 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 
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// 창문물라스를 정의 한다 . 

wcl. cbSize = sizeof (WNDCLASSEX) : 


wcl.Mnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문콜라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이 콘 

wcl. hlconSm = NULL ； // 큰 아이론의 축소판을 사용한다 . 

wcl. hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl. IpszMenuName = "PrintDemoMenu" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 

// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Using the Printer", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결 정 하게 한다 . 
CW_USEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 
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// 건반가속기를 적재한다 . 

hAccel = LoadAccelerators (hThisInst, ” PrintDemoMenu") ; 

// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode) ； 

UpdateWindow (hwnd); 


// 통보문순환고리를 작성 한다 . 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

if(! TranslateAccelerator (hwnd, hAccel, &msg)) { 
TranslateMessage(&msg) ； // 건반통보률 변환한다 . 
DispatchMessage (技 msg) ; // Windows 2000 에 조종을 넘 긴다 . 

} 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 

PAINTSTRUCT ps ； 
int response; 

TEXTMETRIC tm ； 
char str[80] ； 
int i; 

unsigned copies; 

switch (message) { 
case WM_CREATE ： 

// 화면의 크기를 얻는다 . 

maxX = GetSystemMetrics(SM_CXSCREEN) ； 
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maxY = GetSystemMetrics(SM_CYSCREEN) ； 


// 가상창문을 작성한다. 
hdc = GetDC(hwnd) ； 
memDC = CreateCompatibleDC(hdc) ； 


hBit = CreateCompatibleBitmap(hdc, maxX, maxY); 
SelectObject (memDC, hBit) ； 

hBrush = (HBRUSH) GetStockObject(WHITE_BRUSH); 


SelectObject (memDC, hBrush) ； 

PatBlt (memDC, 0, 0, maxX, maxY, PATCOPY); 


// 본문치수를 얻는다. 

GetTextMetrics (hdc, &tm) ； 


strcpy(str, "This is displayed in the main window.") ； 
for(i=0； KNUMLINES； i++) { 

TextOut(memDC, X, Y, str, strlen(str)) ； // 기 억기 에 출력 한다. 
TextOut(hdc, X, Y, str, strlen(str)) ； II 창문에 출력 한다. 

// 행바꾸기한다. 

Y = Y + tm. tmHeight + tm. tmExternalLeading ； 

} 


ReleaseDC (hwnd, hdc) ； 
break； 

case WM.COMMAND： 
switch (LOWORD (wParam)) { 
case IDM.TEXT： 

X = Y = 0； 


// PRINTDLGEX 구조체 를 초기 화한다. 
Printlnit (&printdlgex, hwnd) ； 


if(PrintDlgEx(&printdlgex) != S_OK) break； 

else if(printdlgex.dwResultAction != PD_RESULT_PRINT) break； 


docinfo. cbSize = sizeof (DOCINFO); 
docinfo.IpszDocName = "Printing text”; 
docinfo. IpszOutput = NULL； 
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docinfo. IpszDatatype = NULL ； 
docinfo. fwType = 0 ； 

// 인쇄기의 본문치수률 얻는다 . 

GetTextMetrics (printdlgex. hDC , &tm) ； 

strcpy(str, "This is printed on the printer.”); 


StartDoc (printdlgex. hDC, &docinfo) ； 


for (copies=0 ； copies < printdlgex. nCopies ； copies++) { 
StartPage (printdlgex. hDC) ； 


for(i=0 ； i<NUMLINES ； i++) { 

TextOut(printdlgex. hDC, X, Y, str, strlen(str)) ； 
// 행바꾸기 한다 . 

Y = Y + tm. tmHeight + tm. tmExternalLeading ； 

} 


EndPage (printdlgex. hDC) ； 


EndDoc (printdlgex. hDC) ； 

DeleteDC (printdlgex. hDC); 
break ； 

case IDM_EXIT ： 

response = MessageBox(hwnd, ” Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O) ； 
break ； 

case IDM_HELP ： 

MessageBox(hwnd, "Printing Demo”, "Help”, MB_OK); 
break ； 

} 

break ； 

case WM.PAINT ： // 다시그러 기요구를 처 리 한다 . 
hdc = BeginPaint (hwnd, &ps) ； // 장치 상황을 얻 는다 . 
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BitBlt(hdc, ps. rcPaint. left, ps. rcPaint. top, 

ps. rcPaint. right-ps. rcPaint. left, // 너비 
ps. rcPaint. bottom-ps. rcPaint. top, // 높이 
memDC, 

ps. rcPaint. left, ps. rcPaint. top, 

SRCCOPY) ； 

EndPaint(hwnd, &ps) ； // 장치 상황을 해 제 한다. 
break； 

case WM.DESTROY： // 프로그람을 끝낸다. 

DeleteDC (memDC) ； 

PostQuitMessage (0); 
break； 
default： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리 률 맡긴 다. */ 
return DefWindowProc(hwnd, message, wParam, lParam); 

} 

return 0； 

} 

// PRINTDLGEX 구조체의 초기화 

void Printlnit (PRINTDLGEX *printdlgex, HWND hwnd) 

{ 

printdlgex-MStructSize = sizeof (PRINTDLGEX) : 
printdlgex->hwndOwner = hwnd； 
printdlgex->hDevMode = NULL； 
printdlgex->hDevNames = NULL； 
printdlgex -〉 hDC = NULL； 

printdlgex->Flags = PD.RETURNDC | PD_NOSELECTION | 

PD.NOPAGENUMS | PD.HIDEPRINTTOFILE | 
PD.COLLATE | PD_NOPAGENUMS ； 
printdlgex-〉Flags2 = 0； 
printdlgex->ExclusionFlags = 0； 
printdlgex~>nMinPage = 1; 
printdlgex->nMaxPage = 1； 
printdlgex->nCopies = 1； 
printdlgex->hlnstance = NULL； 
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printdlgex-〉lpCallback = NULL； 
printdlgex -〉； nPropertyPages = 0; 
printdlgex->lphPropertyPages = NULL； 
printdlgex->nStartPage = ST ART_P AGE.GENER AL ； 
printdlgex -〉 dwResult Action = 0； 


printdlgex->lpPrintTemplateName = NULL； 

} 

이 프로그람은 다음과 같은 자원파일을 펼요로 한다. 

#include〈windows. h> 

♦include "print, h" 

PrintDemoMenu MENU 

{ 

POPUP "&Printer Demo" 

{ 

MENUITEM "Print &Text\tF2", IDM_TEXT 
MENUITEM "E&xit\tCtrl+X", IDM_EXIT 

} 

MENUITEM "&Help", IDM_HELP 


PrintDemoMenu ACCELERATORS 

{ 

VK_F2, IDM_TEXT, VIRTKEY 
VK_F1, IDM_HELP, VIRTKEY 
"*X", IDM_EXIT 

} 

머리부파일 PRINT.H 의 내용을 아래에 보여 주었다. 여기에는 이 장의 뒤부분에서 
작성하게 되는 두 실례프로그람에서 사용되는 값들도 정의되여 있다. 

#define IDM.TEXT 100 

ttdefine IDM.BITMAP 101 

#define IDM.EXIT 102 

Mefine IDM.HELP 103 
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#define IDM.WINDOW 104 

ttdefine IDM.ENLARGE 105 

#define IDD.EB1 200 

ttdefine IDD_EB2 201 

ttdefine IDD_UD1 202 

#define IDD_UD2 202 

ttdefine IDD.TEXTl 210 

#define IDD_TEXT2 211 


첫 인쇄실례프로그람의 상세 

이 프로그람에서 중요한 개소는 IDM_TEXT 의 case 문에서 인쇄와 관련한 처리를 
진행하는 부분이 다. 아래 에 다시한번 프로그람코드를 보여 주었 다. 이 프로그람코드는 
사용자가 [Printer Demo ] 차림표에서 [Print Text ] 를 선택하였을 때 실행된다. 

case IDM—TEXT: 

X = Y = 0; 

// PRINTDLGEX 구조체 를 초기화한다. 

Printlnit (&printdlgex, hwnd) ； 


if(PrintDlgEx(&printdlgex) != S_OK) break ； 

else if(printdlgex. dwResultAction != PD_RESULT_PRINT) break ； 


docinfo. cbSize = sizeof (DOCINFO); 
docinfo.IpszDocName = "Printing text”; 
docinfo. IpszOutput = NULL ； 
docinfo. IpszDatatype = NULL ； 
docinfo. fwType = 0; 

// 본문치수를 얻는다. 

GetTextMetrics(printdlgex. hDC, 射 : m) ； 


strcpy(str, ” This is printed on the printer.”); 
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StartDoc (printdlgex. hDC , &docinfo); 

for(copies=0; copies < printdlgex. nCopies； copies++) { 
StartPage (printdlgex. hDC); 


for(i=0； KNUMLINES； i++) { 

TextOut (printdlgex. hDC, X, Y, str, strlen(str)) ； 
// 행바꾸기한다. 

Y = Y + tm. tmHeight + tm. tmExternalLeading； 

} 


EndPage (printdlgex. hDC) ； 

} 


EndDoc (printdlgex. hDC) ； 

DeleteDC (printdlgex. hDC); 
break； 

프로그람코드의 처리내용을 차례로 보자. 우선 인쇄기와 창문에서 본문위치를 가리 
키 는 X 와 Y 가 령 으로 초기 화되 고 있다. 다음 Printlnit ( ) 함수를 호출하여 
PRINTDLGEX 구丄錢를 초기화한다. [ Selection ] 단일선택 단추 및 [ Pages ] 편집 칸을 무효 
로 하고 있는데 대 해 주목하여 야 한다. [Print to file ] 검 사칸도 비 표시 상태 로 되 여 있다. 
이 조종체들은 프로그람에서 사용되지 않는다. 

다음 PrintDlgExC ) 가 실행되고 있다. 돌림값으로서 사용자에 의해 선택된 인쇄기의 
장치 상황이 printdlgex . hDC 에 돌려 진다. 계 속하여 DOCINF ◦ 구조체 가 초기 화된다. 

다음 인쇄 기 의 장치 상황을 파라메 터 로 하여 GetTextMetrics ( ) 가 호출되 고 있 다. 
여기서는 본문을 인쇄 하므로 필요한 복귀，개 행처 리를 진행 하기 위해 본문치수를 얻 어 야 
한다. 이 값들은 1찌 O ? 표 4 T 公의 case 문에 서 얻 고 있는 화면상의 본문과는 다르다. 이 
것은 중요한 점 이 다. 

인쇄기의 장치상황은 특수한것으로서 프로그람에서 사용되는 창문의 장치상황과 공 
통적 인 속성을 가지고 있지 않다. 

인쇄처리를 개시하기 위해서 StartDocO 가 호출된다. 다음 사용자가 요구하는 부수 
의 인쇄가 순환고리를 사용하여 진행된다. 인쇄부수는 printdlgex 의 nCopies 성원으로 
부터 얻는다. 매 폐지는 다른 용지에 인쇄되므로 인쇄를 할 때마다 StartPage () 가 호출 
되고 있다. 

PrirrtDlgEx ( ) 를 호출하여 printdlgex.hDC 에 얻은 장치상황이 TextOut () 함수의 
출력 대 상을 가리 키 는 파라메터 로서 사용되 고 있는 점 에 주목하여 야 한다. 인쇄 기 의 장치 
상황을 엄으면 그것을 다른 장치상황과 꼭같이 사용할수 있다. 매 폐지의 인쇄처리를 끝 
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낼 때 마다 EndPage( ) 함수가 호출되 고 있 다. 모든 인쇄 처 리 가 완료되 면 EndDocC ) 를 
실 행 하고 마감으로 인쇄 기 의 장치 상황을 삭제한다. 

이 실례 프로그람은 단순한것 이지 만 인쇄기 로 문서를 인쇄하는데 필요한 기 본적 인 기 
술들을 모두 반영하고 있다. 이 장의 나머지 부분에서는 비트매프의 인쇄 , 인쇄중지함수 
의 추가 및 척 도설정 방법 에 대 하여 설명한다. 모든 실례프로그람들에 있어서 인쇄 기 로 
출력 을 진 행하는 기 본적 인 수법 은 다 같다. 


비트매프의 인쇄 


Windows 는 도형방식 의 조작체 계이 므로 도형 을 인쇄 할수 있으면 좋을것 이 다. 앞절 
의 실례프로그람에서 보여 준 TextOutC )를 사용하는 본문의 인쇄는 어떤 의미에서 례 
외 적 인것 이 라고 말할수 있 다. 

Windows 2000에서 비 트매 프를 인쇄 하는것 은 결코 어 려 운것 이 아니 다. 그러 나 몇 가 
지 주의해 야 할 점들이 있다. 

우선 비트매프를 인쇄하기전에 선택된 인쇄기가 도형출력기능을 지원하고 있는가를 
확인하여야 한다. 그것은 모든 인쇄기에 도형출력기능이 갖추어 져 있는것은 아니기때문 
이 다. 다음 화면에 표시된 화상의 크기 그대로 비트매프를 인쇄하기 위해 출력의 척도를 
설정해야 한다. 또한 인쇄기의 장치상황에는 비트매프를 선택할수 없다는 시끄러운 문제 
도 있다. (비트매프는 기억기장치상황에만 선택할수 있다.) 

그러므로 비트매프를 인쇄하자면 비트매프를 호환성 있는 장치상황에 선택하고 그것 
을 StretchBltC ) 등의 함수를 사용하여 인쇄 기 의 장치 상황에 복사하는 절 차가 필요하게 
된다. 이 절차를 차례로 설명해 보자. 

인쇄기의 주사선기능몰 확인하기 

모든 인쇄기가 비트매프를 인쇄할수 있는것은 아니다. 례하면 본문밖에 인쇄할수 없 
는 인쇄기도 있다. Windows 의 전문용어에서는 비트매프를 인쇄할수 있는 인쇄기를 주 
사선기능블 가진 인쇄기 라고 부론다. 

주/"스/이라는 말은 본래 비데오영상장치를 가리키는 말이였다. 그러나 말의 의미가 
통일되 여 현재에는 주사선기능을 가지 고 있는 장치 란 비데오영상장치와 마찬가지로 취급 
되는 장치 라는 의미 로 된다. 다시말하여 주사선기능% 가진 인쇄기 란 도형 을 출력할수 
있는 인쇄기를 말한다. 

현재 쓰이고 있는 일반적 인 인쇄기들은 주사선기능을 가지고 있다. 그러 나 주사선기 
능을 가지지 못한 인쇄기들도 아직까지 일부 사용되고 있으므로 비트매프를 인쇄하기에 
앞서 확인해 볼 필요가 있다. 그를 위 해 GetDeviceCaps( ) 함수를 사용한다. 선언은 다 
음과 갈다. 
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int GetDeviceCaps (HDC hdc , int attribute ) : 

hdc 에 는 정 보를 얻 을 대 상으로 되 는 장치 상황의 손잡이 를 설 정한다. attribute 의 
값은 얻으러는 정보의 종류를 지정한다. 이 함수는 요구하는 정보를 돌려 준다. 얻을수 
있는 정 보에 는 많은 종류가 있지 만 대 다수의 정 보들은 이 장에서 리 용되 지 않는다 . ( 자체 
로 GetDeviceCaps () 를 리 용하여 여 러 가지 정보를 얻 어 보는것 이 좋다. 장치 에 관한 정보 
를 놀라울 정도로 많이 얻을수 있다.) 인쇄기로 비트매프를 출력할수 있는가를 확인하려 
면 attribute 에 RASTERCAPS 를 설정한다. 함수의 돌림값으로서 인쇄기에 주사선기능이 
갖추어 져 있는가 없는가가 돌려 진다. 이것은 다음의 몇개 값들의 조합으로 된다. 


RC—BANDING 

인쇄기의 장치상황은 도형의 밴딩지원을 펼요로 
한다. 

RC.BITBLT 

인쇄 기의 장치상황은 BitBltC ) 의 목표로 얻게 된다. 

RC — BITMAP 64 

인쇄 기 의 장치상황은 64 KB 이상의 크기 의 비 트매 
프를 처 리할수 있 다. 

RC _ DI_BITMAP 

인 쇄 기 의 장 치 상 황 은 SetDlBits ( ) 나 
GetDIBitsC ) 등에 서 사용되 는 장치 독립 비 트매 프 
를 제공하고 있다. 

RC—DIBTODEV 

인쇄 기 의 장치상황은 SetDlBitsToDevice ( )를 
제공한다. 

RC.FLOODFIL 

인쇄기의 장치상황은 색칠하기를 제공한다. 

RC PALETTE 

인쇄기의 장치상황은 조색판을 제공한다. 

RC—SCALING 

인쇄기의 장치상황은 척도기능을 가지고 있다. 

RC_STRETCHBLT 

인쇄기의 장치상황은 stretchBltC ) 의 목표로 얻 
게 된다. 

RC—STRETCHDIB 

인쇄기의 장치상황은 StretchDlBits ( ) 의 목표로 
얻게 된다. 


이 장의 범위 내 에서는 RC—BITBLT 와 RC—STRETCHBLT 악 기능만을 확인할수 있 
으면 충분하다. 


적도의 설정 


화면 에 표시 된 비 트매 프를 본래 의 크기 대 로 인쇄 기 로 출력하려 면 척 도를 적 당하게 
설정하여 야 한다. 그러 자면 화면과 인쇄 기 의 해 상도를 알아야 할 필요가 제 기 된다. 해 상 
도를 조사하려 면 역 시 GetDeviceCaps ( ) 함수를 리 용해 야 한다. 수평 방향의 linch 당 화 
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소 ( pixel ) 수를 엄 으려 면 attribute 에 LOGPIXELSX 를 설정 해 야 한다. 수직 방향의 
linch 당 화소수를 얻기 위해서는 attribute 에 LOGPIXELSY ^ 설정해야 한다. 아래에 
실례를 보여 주었다. 


hres = GetDeviceCaps(hdc, LOGPIXELSX); 

vres = GetDeviceCaps (hdc, LOGPIXELSY) : 

hdc 에 는 장치 상황의 손잡이 를 설정 한다. hres 에 X 축방향의 linch 당 화소수가 돌 
려 지고 vres 에 Y 축방향의 linch 당 화소수가 돌려 진다. 

화면의 장치 상황과 인쇄 기 의 장치 상황의 해 상도를 엄 으면 그것 들을 변환하기 위한 
배 률을 계 산할수 있 다. 이 배 률을 StretchBltC ) 에 설 정하여 비 트매 프를 출력하면 인쇄 
기로 화면과 꼭 같은 화상을 얻을수 있다. 

StretchBltC ) 

StretchBltC ) 는 비 트매 프를 복사하는 기 능에 있어 서 는 이 책의 앞부분에 서 설명 한 
BitBlt ( ) 와 같다. 다만 복사처 리 에 있어서 StretchBltC ) 는 복사원천의 비 트매 프를 복사 
측의 령역에 맞추어 확대하거나 축소할수 있다. 아래에 선언을 보여 주었다. 

BOOL StretchBlt(HDC hDest , int DestX , int DestY , 
int DestWidth , int DestHeight , 

HDC hSource , int SourceX , int SourceY , 
int SourceWidth , int SourceHeight , 

DWORD dwHow ) : 

hDest 에는 복사측의 장치상황의 손잡이 를 설정 한다. DestX 와 DestY 에는 비트매프 
를 써넣는 왼쪽 웃모서리의 자리표를 설정한다. DestWidth 와 DestHeight 에는 복사측 
의 령역의 너비와 높이를 설정한다. hSource 에는 복사원천측의 장치상황의 손잡이를 설 
정 한다. SourceX 와 SourceY 에는 복사원천측의 비트매프의 왼쪽 웃모서 리의 자리표를 
설정 한다. SourceWidth 와 SourceHeight 에 는 복사원천측의 비 트매 프의 너 비 와 높이 를 
설정 한다. 

StretchBlt ( ) 는 복사측의 크기에 맞추어서 복사원천측의 비트매프를 자동적으로 확 
대 하거 나 축소한다. 이 기능은 확대 나 축소기능을 가지지 않는 BitBltC )와의 차이 이 다. 

dwHow 의 값은 비트매프의 비트단위의 복사방법을 지적한다. 여기에서는 BitBlt ( ) 의 
파라메터 에 설정된 값과 같은것 이 사용된다. 흔히 사용되는 값들을 아래 에 보여 주었다. 
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SRCAND 

복사측의 비트매 프와 AND 연산을 진 
행 한다. 

SRCCOPY 

비 트매 프를 덧쓰기 복사한다. 

SRCERASE 

복사측의 비 트매 프를 반전한것 과 
AND 연산을 진행한다. 

SRCINVERT 

복사측의 비트매프와 XOR 연산을 진 
행 한다. 

SRCPAINT 

복사측의 비트매 프와 OR 연산을 진행 
한다. 


StretchBltC ) 는 비 트매 프의 인쇄 에 서 중요한 함수이 다. 왜 냐하면 출력 효과의 배 률 
을 설정할수 있기때문이다. StretchBltC ) 는 필요에 따라 복사하는 측의 령역에 맞추어서 
복사원천측의 비트매프를 확대 또는 축소한다. 복사측의 령역의 크기에 배률을 맞춤으로 
서 StretchBltC )를 사용하여 비트매프의 인쇄척도를 설정할수 있다. 

만일 척도의 설정이 필요 없다면 BitBltO 를 사용하여 비트매프를 인쇄할수도 있다. 
이 경우에는 인쇄된 비트매프의 화상이 화면에 표시된것과 다를뿐이다. 두가지 수법을 
사용한 실례프로그람을 후에 작성한다. 

인쇄기와 호환성이 있는 장치상황을 얻기 

비 트매 프의 인쇄 에 있어 서 비 트매 프를 선택할수 있는것 은 기 억 기 장치 상황뿐이 라는 
문제가 있다. 사소한것이지만 시끄러운 문제이다. 즉 PrintDlgEx ( ) 나 CreateDC ( ) 에 
서 얻 어 진 인쇄 기 장치 상황에 직 접 비 트매 프를 선택할수 없 다는것이다. 

비트매프를 인쇄하자면 우선 호환성 있는 기억기장치상황을 작성하고 그 기억기장치 
상황에 비트매프를 선택하며 마감에 그것을 BitBlt ( ) 또는 StretchBltC )를 사용하여 인 
쇄기장치상황에 복사하는 절차가 필요하게 된다. 

또 하나의 시끄러운 문제 가 있다. 그것은 인쇄하려는 비트매프가 인쇄기장치상황과 
호환성 이 없을 가능성 이 있 다는것 이 다. 이 러 한 경 우에 는 먼저 인쇄 기 와의 호환성 이 있는 
비트매프를 작성한다. 

다음 그 비트매프를 인쇄기와의 호환성이 있는 기억기장치상황에 선택하고 인쇄하려 
는 비트매프를 인쇄기와의 호환성 이 있는 비트매프에 복사한다. 마지막에 그 비트매프를 
인쇄기의 장치상황에 복사한다. 

이 려한 절차는 시끄러운것 이지만 Windows 2000 자체 가 이렇게 설계되 여 있기때문에 
다른 방도가 없다. 다만 실제의 프로그람코드는 그닥 복잡한것으로 되지는 않는다. 

비트매프를 인쇄하는 실 례프로그람 

실 례 17-2 의 프로그람은 첫 인쇄 실 례프로그람에 두가지 기 능을 추가한것 이 다. 첫 번 
째 기 능은 비 트매 프를 인쇄하는 기 능이 다. 척 도설정 을 진행하는 경 우와 진행하지 않는 
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경우의 인쇄결과의 차이를 확인할수 있게 되여 있다. 

두번째 기능은 프로그람의 기본창문의 내용을 그대로 인쇄하는 기능이다. 이것은 간 
단히 실현할수 있 다. 왜 냐하면 이 프로그람에서는 제 7 장에 서 설명 한 가상창문 A ♦ 욜 사 
용하므로 기본창문의 내용이 항상 비트매프로서 보관되여 있기때문이다. 그러므로 기본 
창문의 내용을 인쇄하는것은 비트매프를 인쇄하는 일반적 인 순서와 꼭같이 실현할수 있 
다. 


실 례 17-2. Prin 松프로그람 

// 비트매프를 인쇄하는 실례프로그람 

// 이 정의를 필요로 하는 번역프로그람도 있다. 
♦define WINVER 0x0500 


itinclude〈windows. h> 
ttinclude <cstring> 
include ” print, h，， 


#define NUMLINES 25 


ttdefine BMPWIDTH 256 
#define BMPHEIGHT 128 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
void Printlnit (PRINTDLGEX *printdlgex, HWND hwnd) ； 


char szWinName[] = ” My Win"; // 창문들라스의 이름 

int X = 0, Y = 0； // 현재의 출력위치 
int maxX, maxY； // 화면의 크기 

HDC memDC, memPrDC； // 가상장치의 손잡이 
HBITMAP hBit, hBit2, hlmage； // 비트매프의 손잡이 
HBRUSH hBrush； // 붓의 손잡이 


PRINTDLGEX printdlgex； 
DOCINFO docinfo； 
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int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HACCEL hAccel ； 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

// 창문물라스를 정의 한다 . 

wcl. cbSize = sizeof (WNDCLASSEX) ; 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 

wcl.lpszMenuName = "PrintDemoMenu2" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) : 

// 창문콜라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문콜라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Using the Printer", // 제목 

WS_OVERLAPPEDWINDOW, II 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
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CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // 너비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 높이 는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

)； 


// 건반가속기를 적재 한다 . 

hAccel = LoadAccelerators (hThisInst, ” PrintDemoMenu2") ; 


// 비트매프를 적재한다 . 

hlmage = LoadBitmap(hThisInst, "MyBPl") : 


// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode) : 

UpdateWindow (hwnd) : 

// 통보문순환고리를 작성 한다 . 

while(GetMessage (&msg, NULL, 0, 0)) 

{ 

if (! TranslateAccelerator (hwnd, hAccel, 技 msg)) { 
TranslateMessage(&msg) : // 건반통보를 변환한다 . 
DispatchMessage(toisg) ; // Windows 2M0 에 조종을 넘 긴다 . 

} 

} 


return msg.wParam; 

} 


/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 
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HDC hdc ； 
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PAINTSTRUCT ps ； 
int response; 

TEXTMETRIC tm ； 
char str[250] : 
int i; 

unsigned copies; 

double VidXPPI, VidYPPI, PrXPPI, PrYPPI ； 
double Xratio, Yratio ； 

RECT r ； 


switch (message) { 
case WM_CREATE: 

// 화면의 크기를 얻는다 . 

maxX = GetSystemMetrics(SM_CXSCREEN) ； 

maxY = GetSystemMetrics(SM_CYSCREEN) ； 

// 가상창문을 작성 한다 . 

hdc = GetDC(hwnd) ； 

memDC = CreateCompatibleDC(hdc) ； 

hBit = CreateCompatibleBitmap(hdc, maxX, maxY); 

SelectObject (memDC, hBit) ； 

hBrush = (HBRUSH) GetStockObject(WHITE_BRUSH); 
SelectObject (memDC, hBrush) ； 

PatBlt (memDC, 0, 0, maxX, maxY, PATCOPY) ； 

ReleaseDC (hwnd, hdc) ； 
break ； 

case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM.TEXT ： // 본문을 인쇄한다 . 

X = Y = 0 ； 


// PRINTDLGEX 구조체 를 초기 화한다 . 
Printlnit (&printdlgex, hwnd) ； 


if(PrintDlgEx(&printdlgex) != S_OK) break ； 

else if(printdlgex.dwResultAction != PD_RESULT_PRINT) break ； 
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docinfo. cbSize = sizeof (DOCINFO) ； 
docinfo.IpszDocName = "Printing Text"; 
docinfo. IpszOutput = NULL; 
docinfo. IpszDatatype = NULL ； 
docinfo. fwType = 0 ； 

// 인쇄기의 본문치수률 얻는다 . 

GetTextMetrics (printdlgex. hDC , &tm) ； 

strcpy(str, "This is printed on the printer.”); 


StartDoc (printdlgex. hDC, &docinfo); 


for (copies=0 ； copies < printdlgex. nCopies ； copies++) { 
StartPage (printdlgex. hDC) ； 


for(i=0 ； i<NUMLINES ； i++) { 

TextOut(printdlgex. hDC, X, Y, str, strlen(str)) ； 
// 개 행 한다. 

Y = Y + tm. tmHeight + tm. tmExternalLeading ； 

} 


EndPage (printdlgex. hDC) ； 


EndDoc (printdlgex. hDC) ； 

DeleteDC (printdlgex. hDC); 
break ； 

case IDM_BITMAP ： // 비트매프를 인쇄 한다 . 
// PRINTDLGEX 구조체 를 초기 화한다 . 
Printlnit (&printdlgex, hwnd) ； 


if(PrintDlgEx(&printdlgex) != S_OK) break ； 

else if (printdlgex. dwResultAction != PD_RESULT_PRINT) break ； 


docinfo. cbSize = sizeof (DOCINFO); 
docinfo.IpszDocName = "Printing bitmaps”; 
docinfo. IpszOutput = NULL ； 
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docinfo. IpszDatatype = NULL ； 
docinfo. fwType = 0 ； 


if (! (GetDeviceCaps (printdlgex. hDC, RASTERCAPS) 

& (RC_BITBLT | RC_STRETCHBLT))) { 

MessageBox(hwnd, "Cannot Print Raster Images", 

"Error", MB_OK); 

break ； 

} 

// 인쇄기와 호환성 있는 기억기장치상황을 작성한다 . 
memPrDC = CreateCompatibleDC (printdlgex. hDC) ； 

// 인쇄기장치상황과 호환성 있는 비트매프를 작성한다 . 

hBit2 = CreateCompatibleBitmap (printdlgex. hDC, maxX, maxY); 

SelectObject (memPrDC, hBit2); 


// 비트매프를 기 억기장치상황에 선택한다 . 


SelectObject (memDC, hlmage) ; 


// 비트매프를 인쇄 기와 호환성을 가지는 장치상황에 복사한다 . 
BitBlt(memPrDC, 0, 0, BMPWIDTH, BMPHEIGHT, 
memDC, 0, 0, SRCCOPY); 

// linch 당 화소수를 얻는다 . 

VidXPPI = GetDeviceCaps (memDC, LOGPIXELSX); 
VidYPPI = GetDeviceCaps (memDC, LOGPIXELSY); 

PrXPPI = GetDeviceCaps (printdlgex. hDC, LOGPIXELSX); 
PrYPPI = GetDeviceCaps (printdlgex. hDC, LOGPIXELSY); 

// 배률을 얻는다 . 

Xratio = PrXPPI / VidXPPI ； 

Yratio = PrYPPI / VidYPPI ； 

SelectObject(memDC, hBit); // 가상창문에 보관한다 . 

StartDoc(printdlgex. hDC, Sdocinfo) : 

for (copies=0 : copies < printdlgex. nCopies; copies++) { 
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StartPage (printdlgex. hDC); 


// 비트매프를 그대로 인쇄기장치상황에 복사한다 . 

BitBlt (printdlgex. hDC, 0, 0, BMPWIDTH, BMPHEIGHT, 
memPrDC, 0, 0, SRCCOPY) ； 

// 비트매프를 적 당한 배률로 복사한다 . 

StretchBlt (printdlgex. hDC, 0, BMPHEIGHT + 100, 

(int) (BMPWIDTH*Xratio), 

(int) (BMPHEIGHT*Yratio), 
memPrDC, 0, 0, 

BMPWIDTH, BMPHEIGHT, 

SRCCOPY) ； 


EndPage (printdlgex. hDC) ； 

} 


EndDoc (printdlgex. hDC) ； 

DeleteDC (memPrDC) ； 

DeleteDC (printdlgex. hDC); 
break ； 

case IDM.WINDOW ： // 창문의 내용을 인쇄한다 . 
GetClientRect (hwnd, &r) ； 
hdc = GetDC(hwnd); 

// 창문에 본문을 표시한다 . 

GetTextMetrics (hdc, &tm) ； 

X = Y = 0 ； 

strcpy(str, ” This is displayed in the main window. ”) ; 
for(i=0 ； KNUMLINES ； i++) { 

TextOut(hdc, X, Y, str, strlen(str)) ； 

TextOut (memDC, X, Y, str, strlen(str)) ； 

// 개 행 한다 . 

Y = Y + tm. tmHeight + tm.tmExternalLeading; 

} 

// 창문에 비트매 프를 표시한다 . 

SelectObject (memDC, hlmage) ； 
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BitBltChdc, 100, 100, BMPWIDTH, BMPHEIGHT, 
memDC, 0, 0, SRCCOPY); 

// 다시그리기요구에 대응하기 위 해 창문의 화상을 보관한다 . 
SelectObject (memDC , hBit ) ; 

BitBlt(memDC, 0, 0, r. right, r. bottom, hdc, 0, 0, SRCCOPY); 

// 호환성 있는 장치상황을 작성한다 . 
memPrDC = CreateCompatibleDC (hdc) : 

// 호환성 있는 비트매프를 작성한다 . 

hBit2 = CreateCompatibleBitmap(hdc, r. right, r. bottom) : 
SelectObject (memPrDC, hBit2) : 

// 인쇄를 위해 창문의 화상을 보관한다 . 

BitBlt(memPrDC, 0, 0, r. right, r. bottom, 
hdc, 0, 0, SRCCOPY); 


// PRINTDLGEX 구조체 를 초기 화한다 . 
Printlnlt (&printdlgex, hwnd); 


if(PrintDlgEx(Sprintdlgex) != S_OK) break ； 

else if (printdlgex.dwResultAction != PD_RESULT_PRINT) break ； 


docinfo. cbSize = sizeof (DOCINFO); 
docinfo. IpszDocName = "Printing Window" : 
docinfo. IpszOutput = NULL ； 
docinfo. IpszDatatype = NULL ； 
docinfo. fwType = 0 ； 

// linch 당 화소수를 얻는다 . 

VidXPPI = GetDeviceCaps (memDC, LOGPIXELSX); 
VidYPPI = GetDeviceCaps (memDC, LOGPIXELSY) : 

PrXPPI = GetDeviceCaps (printdlgex. hDC, LOGPIXELSX) : 
PrYPPI = GetDeviceCaps (printdlgex. hDC, LOGPIXELSY); 

// 배률을 얻는다 . 

Xratio = PrXPPI / VidXPPI ； 

Yratio = PrYPPI / VidYPPI ； 
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if ( ! (GetDeviceCaps (printdlgex. hDC ， RASTERCAPS) 

& RC—STRETCHBLT)) { 

MessageBox(hwnd, ” Cannot Print Raster Images”, 
"Error", MB_OK) ； 

break ； 


StartDoc (printdlgex. hDC, &docinfo); 

for(copies=0; copies < printdlgex. nCopies ； copies++) { 
StartPage (printdlgex. hDC) ； 


StretchBlt (printdlgex. hDC, 0, 0, 

(int) (r. right*Xratio), 

(int) (r. bo 竹 om*Yratio), 

memPrDC, 0, 0, (int) r. right, (int) r. bottom, 
SRCCOPY) ； 

EndPage (printdlgex. hDC) ； 

} 

EndDoc (printdlgex. hDC) ； 

DeleteDC (printdlgex, hDC); 

DeleteDC (memPrDC); 

ReleaseDC (hwnd, hdc) ； 
break ； 

case IDM_EXIT ： 

response = MessageBox (hwnd, ” Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O) ； 
break ； 

case IDM_HELP ： 

MessageBox (hwnd, "Printing Demo”, "Help”, MB_OK) ； 
break ； 
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case WM.PAINT: // 다시그리 기요구를 처 리한다 . 
hdc = BeginPaint(hwnd, &ps); // 장치 상황을 얻 는다 . 

BitBlt(hdc, ps. rcPaint. left, ps. rcPaint. top, 

ps. rcPaint. right-ps. rcPaint. left, // 너비 
ps. rcPaint. bottom-ps. rcPaint. top, // 높이 
memDC, 

ps. rcPaint. left, ps. rcPaint. top, 

SRCCOPY) ； 


EndPaint(hwnd, &ps) ； // 장치 상황을 해 제 한다 . 
break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

DeleteDC (memDC); 

PostQuitMessage (0); 
break ； 
default : 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리 률 맡긴 다 . */ 
return DefWindowProc(hwnd, message, wParam, lParam); 


return 0 ； 


// PRINTDLGEX 구조체의 초기화 

void Printlnit (PRINTDLGEX *printdlgex, HWND hwnd) 

{ 

printdlgex->lStructSize = sizeof (PRINTDLGEX) ； 
printdlgex->hwndOwner = hwnd ； 
printdlgex->hDevMode = NULL ； 
printdlgex -〉 hDevNames = NULL ； 
printdlgex->hDC = NULL ； 

printdlgex->Flags = PD.RETURNDC | PD.NOSELECTION | 

PD_NOPAGENUMS | PD.HIDEPRINTTOFILE | 
PD_COLLATE | PD_NOPAGENUMS ； 
printdlgex->Flags2 = 0; 
printdlgex->ExclusionFlags = 0; 
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printdlgex->nMinPage = 1 ； 
printdlgex -〉 nMaxPage = 1; 
printdlgex->nCopies = 1; 
printdlgex->hlnstance = NULL ； 
printdlgex -〉 lpCallback = NULL ； 
printdlgex->nPropertyPages = 0; 
printdlgex->lphPropertyPages = NULL ； 
printdlgex->nStartPage = ST ART_P AGE_GENER AL ； 
printdlgex->dwResult Action = 0 ； 

printdlgex->lpPrintTemplateName = NULL ； 

} 

이 프로그람은 아래와 같은 자원파일을 필요로 한다. 

#include < windows. h> 

^include "print, h" 

MyBPl BITMAP BP. BMP 


PrintDemoMenu2 MENU 

{ 

POPUP M &Printer Demo" 

{ 

MENUITEM ” Print &Text\tF2 M , IDM.TEXT 
MENUITEM "Print &Bitmap\tF3 M , IDM_BITMAP 
MENUITEM ” Print &Window\tF4 n , IDM.WINDOW 
MENUITEM ”E&xit\tCtrl+X", IDM_EXIT 

} 

MENUITEM ” &Help”, IDM.HELP 


PrintDemoMenu2 ACCELERATORS 

{ 

VK_F2, IDM_TEXT, VIRTKEY 
VK_F3, IDM_BITMAP, VIRTKEY 
VK_F4, IDM.WINDOW, VIRTKEY 
VK_F1, IDM.HELP, VIRTKEY 


676 


교육성 프로그람교육쎈터 



제 17 장. 인쇄기의 사용법 


니 


그림 17-2. 비 m 매프를 인쇄하는 실례프로그람의 실행결과 
기 ) 화면에 표시된 창문 , L) 인쇄된 비트매프 , : C:) 인쇄결과 


이 프로그람은 비트매프파일을 필요로 한다. 프로그람코드에서 볼수 있는것처럼 비 
트매프의 크기는 너비가256 화소, 높이 128 화소로 되여 야 한다. 그러 나 BMPWIDTH 와 
BMPHEIGHT 정의를 변경시키면 임의의 크기의 비트매프를 사용할수도 있다. 비트매프 
파일을 BP.BMP 라는 이 름으로 작성하여 둔다. 


"~X", IDM_EXIT 


프로그람실 행 결 과를 그림 17-2 에 준다. 


Printer Demo Help 



This is displayed in the main window. 
This is displayed in the main window. 
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비트매프를 인쇄하는 실 례프로그람의 상세 

IDM _ BITMAP 의 case 문 부분의 프로그람코드를 보자. 이 프로그람코드는 사용자가 
차림표로부터 [Print Bitmap ] 를 선택했을 때 실행된다. 아래에 다시 프로그람코드를 보 
여 준다. 

case IDM_BITMAP: // 비트매프률 인쇄 한다 . 

// PRINTDLGEX 구조체 를 초기화한다 . 

Printlnit (&printdlgex, hwnd) ； 


if(PrintDlgEx(&printdlgex) != S_OK) break ； 

else if(printdlgex. dwResultAction != PD_RESULT_PRINT) break ； 


docinfo. cbSize = sizeof (DOCINFO); 
docinfo.IpszDocName = "Printing bitmaps”; 
docinfo. IpszOutput = NULL ； 
docinfo. IpszDatatype = NULL ； 
docinfo. fwType = 0; 


if (! (GetDeviceCaps (printdlgex. hDC, RASTERCAPS) 

技 (RC_BITBLT | RC_STRETCHBLT))) { 

MessageBox(hwnd, "Cannot Print Raster Images”, 

” Error ”, MB_OK) ； 

break ； 

} 

// 인쇄기와 호환성 있는 기억기장치상황을 작성한다 . 
memPrDC = CreateCompatibleDC (printdlgex. hDC) ； 

// 인쇄기장치상황과 호환성 있는 비트매프를 작성한다 . 

hBit2 = CreateCompatibleBitmap (printdlgex. hDC, maxX, maxY); 

SelectObject (memPrDC, hBit2) ； 


// 비트매프를 기 억기장치상황에 선택 한다 . 
SelectObject (memDC, hlmage) ； 


// 비트매프를 인쇄기와 호환성을 가지는 장치상황에 복사한다 . 
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BitBltCmemPrDC, 0, 0, BMPWIDTH, BMPHEIGHT, 
memDC, 0, 0, SRCCOPY); 

II linch 당 화소수를 얻 는다 . 

VidXPPI = GetDeviceCaps (memDC, LOGPIXELSX) ; 
VidYPPI = GetDeviceCaps (memDC, LOGPIXELSY); 

PrXPPI = GetDeviceCaps(printdlgex.hDC, LOGPIXELSX); 
PrYPPI = GetDeviceCaps (printdlgex. hDC, LOGPIXELSY); 

// 배률을 엄는다 . 

Xratio = PrXPPI / VidXPPI ； 

Yratio = PrYPPI / VidYPPI ； 

SelectObject(memDC, hBit); // 가상창문에 보관한다 . 

StartDoc(printdlgex. hDC, Sdocinfo) : 

for (copies=0 : copies < printdlgex. nCopies; copies++) { 
StartPage (printdlgex. hDC) : 


// 비트매프를 그대로 인쇄 기장치상황에 복사한다 . 

BitBlt(printdlgex. hDC, 0, 0 ， BMPWIDTH, BMPHEIGHT, 
memPrDC, 0 ， 0, SRCCOPY); 


// 비트매프를 적당한 배률로 복사한다 . 

StretchBlt (printdlgex. hDC, 0, BMPHEIGHT + 100, 
(int) (BMPWIDTH*Xratio), 

(int) (BMPHEIGHT*Yratio), 
memPrDC, 0, 0, 

BMPWIDTH, BMPHEIGHT, 

SRCCOPY) : 


EndPage (printdlgex. hDC) : 


EndDoc (printdlgex. hDC); 
DeleteDC (memPrDC) : 
DeleteDC (printdlgex. hDC) : 
break ； 
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인쇄 기 의 장치 상황을 얻 고 docinfo 의 초기 화가 완료되 면 GetDeviceCaps () 를 호출 
하여 인쇄기가 필요한 주사선기능을 가지고 있는가를 확인한다. 도형출력기능을 가지지 
못한 인쇄 기 라면 비 트매 프를 인쇄할수 없 다. 

인쇄 기 에서 비트매 프를 인쇄할수 있는가를 확인하면 인쇄 기와 호환성 이 있는 장치상 
황 (memPrDC) 과 비트매프 (hBit2) 를 작성한다. 인쇄기와 호환성 있는 비트매프의 크기 
로서 maxX 와 maxY 를 사용하므로 화면의 크기이내의 임의의 크기의 비트매프를 작성 
할수 있다. (만일 매우 큰 비트매프를 인쇄하려고 한다면 이 변수들의 값을 크게 할 필요 
가 있다.) 

다음 hBit2 를 인쇄기와 호환성 있는 기억기장치상황아 설정하고 있다. 

표시 되는 비 트매 프(손잡이 는 hlmage) 는 memDC 로 가리 키는 기 억 기 장치 상황에 선 
택된다. 이것은 통보문을 처 리하는데 사용되 는 가상창문을 지 원하기 위한 

기 억기장치상황과 갈은것 이 다. 여기 에서는 두가지 목적으로 이 기 억기 장치상황이 사용되 
고 있다. (따로따로 기억기장치상황을 사용할수도 있으나 여기에서는 그럴 필요가 없다.) 

다음 비트매프가 memDC 로부터 memPrDC 에 복사된다. 이 중간처리가 필요한 려유 
는 BP.BMP 에 보관된 비 트매 프가 화면의 장치상황과는 호환성 이 있어도 인쇄 기의 장치 
상황과는 호환성 이 없기 때 문이 다. 그러 므로 비 트매 프를 직 접 memPrDC 에 선택할수는 
없다. 

다음 절 차로서 배 률계 산을 진행한다. 그를 위 해 화면과 인쇄 기 각각의 linch 당 화 
소수를 엄고 그 값으로부터 배률을 구한다. 

마지막으로 비트매프를 인쇄기에 출력하고 있다. 먼저 BitBltC ) 를 사용하여 그대로 
복사하고 있다. 이것에 의하여 두개 장치의 형태상 차이를 고려하지 않고 비트매프가 인 
쇄된다. 다음 StretchBlt( )를 사용하여 배률을 설정하고 비트매프를 인쇄하고 있다. 인 
쇄결과를 보면 알수 있는것처럼 척도를 설정한 비트매프는 화면에 표시된 비트매프에 가 
까운 화상으로 된다. 

IDM_WINDOW 의 case 문의 프로그람코드는 IDM_BITMAP 의 case 문과 류사한 처 
리를 진행하므로 내용을 쉽게 리해할수 있다. 


|다시 한보 전진| 


낡은 형식의 인쇄대화칸의 작성 

Windows 2000 이전에는 인쇄공통대화칸을 표시 하는데 PrintDlg( ) 함수가 사 
용되고 있었다. 이 대화칸에는 최신의 PrintDlgExC ) 가 제공하는것과 같은 유연 
성 이 없다. 그러나 낡은 프로그람코드에서 사용되고 있는 PrintDlg( )를 
PrintDlgEx( ) 로 바꾸는 작업을 진행하게 되는 경우도 있게 되므로 PrintDlgC ) 
함수의 사용방법을 알아 두어 야 할 필요가 있다. 

Prh 止 Dlg ( ) 함수와 선언은 다음과 같다. _ 
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BOOL PrintDlg (LPPRINTDLG PrintDlg ); 

사용자가 [ OK ] 단추를 눌러 서 대 화칸을 연 경 우 함수의 귀 환값으로 령 아닌 
값이 돌려 진 다. 사용자# [ Cancel ] 단추 (또는 [ Esc ] 건) 혹은 체 계차림 표를 사용 
하여 대화칸을 닫은 경우는 령 이 돌려 진다. 

PrintDlg 가 가리키는 PRINTDLG 구조체의 내용은 PrintDlgO 의 조작방법을 
설정 하기 위 한것 이 다. PRINTDLG 구조제와 정 의는 다음과 같다. 

typedef struct tagPD n{ 

DWORD IStructSize ； 

HWND hwndOwner ； 

HGLOBAL hDevMode ； 

HGLOBAL hDevNames ； 

HDC hDC ； 

DWORD Flags ； 

WORD nFromPage ； 

WORD nToPage ； 

WORD nMinPage ； 

WORD nMaxPage; 

WORD nCopies ； 

HINSTANCE hlnstance ； 

LPARAM lCustData ； 

LPPRINTHOOKPROC lpfnPrintHook ； 

LPSETUPHOOKPROC lpfnSetupHook ； 

LPCSTR IpPrintTemplateName ； 

LPCSTR IpSetupTemplateName ； 

HGLOBAL hPrintTemplate ； 

HGLOBAL hSetupTemplate ； 

} PRINTDLG ； 

정의를 보면 알수 있는바와 같이 PRINTDLG 구조체의 성원의 대다수는 
PRINTDLGEX 구조체 의 성 원과 같다. 큰 차이 는 폐 지 범 위 를 (nFromPage 와 
nToPage 를 사용하여 ) 한개 밖에 선택 할수 없 다는것 이 다. PRINTDLGEX 구조체 에 
서 는 여 러 개 의 페 지 범 위 를 지 원 한 다 . hSetupTemplate , lcustData 및 
lpfnPrintfHook 등의 성원은 PrintDlgExC ) 에서는 필요로 하지 않는다. 
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중지함수의 추가 


지 금까지 의 실 례 프로그람들에 서는 인쇄 기 (실제 로는 인쇄 완충기 ) 에 출력을 한 다음 
그것을 방치해 두었다. 이것은 출력이 완료되면 프로그람의 일감도 끝난다는것이다. 그 
리나 실제의 응용프로그람은 이렇게 단순한것이 아니다. 인쇄처리중에 오유가 발생하거 
나 인쇄일감을 중지하지 않으면 안되는 경우도 있다. 사용자의 결심이 변하여 인쇄일감 
을 도중에 중지시키 려고 하는 경우도 있다. 

이러한 상황에 대응하기 위해서는 프로그람에 인쇄증지함수와 인쇄가 완료되기전에 
인쇄일 감을 중지 하기 위 한 대 화칸을 작성 하여 야 한다. 표준적 인 Windows 응용프로그람 
의형식을 갖추자면 모든 프로그람이 이러한 기능을 지원할 필요가 있다. 이 절에서는 
인쇄를 중지하는 방법을 설명한다. 

SetAbortProc( ) 

중지 함수를 작성 하기 위 해 프로그람에 서 SetAbortProc ( ) 를 사용한다. 아래 에 선 언 
을 보여 주었다. 


int SetAbortProc (HDC hPrDC , ABORTPROC AbortFunc ); 


比 PrDC 에 인쇄 기의 장치 상황의 손잡이 를 설정 한다. AbortFunc 에 중지 함수로 하려 
는 함수의 이름을 설정한다. 이 함수는 호출이 성공하면 령보다 큰 값을 돌려 주며 실패 
하면 SP_ERROR 를 돌려 준다. 

중지 함수의 선언은 다음과 같다. 


BOOL CALLBACK AbortFunc (HDC hPrDC , int Code ); 

이 함수가 호출되면 hPrDC 에 인쇄기의 장치상황의 손잡이가 보관된다. 오유가 발 
생 하지 않으면 Code 의 값은 령으로 된다. 만일 필요하다면 Code 의 값을 확인하여 프 
로그람에서 적 당한 오유처 리를 할수도 있다. 그러 나 중지 함수를 작성해 두면 인쇄관리자 
(Print manager ) 가 오유를 처 리 하여 주므로 Code 를 무시 하여도 문제가 없다. 인쇄를 
계속하려는 경우는 중지함수의 돌림값으로서 령 아닌 값을 돌려 주며 인쇄를 중지하려는 
경우는 령을 돌려 준다. 

중지 함수안에 는 통보문순환고리 를 작성하여 야 한다. 그러 나 통보문을 얻 는데 는 
GetMessageC ) 가 아니 라 PM_REMOYE 를 지정 한 PeekMessage ( )를 사용해 야 한다. 
그 리 유는 통보문기 다림 렬 에 통보문이 존재 하지 않는 경우에 GetMessage () 는 통보문을 
계속 기 다리고 있으나 PeekMessageC ) 는 통보문을 기다리지 않기때문이 다. 그러므로 
중지 함수의 골격코드는 다음과 같이 된다. 
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// 인쇄 중지함수 

BOOL CALLBACK AbortFunc (HDC hdc, int err) 
{ 


MSG message ； 


while(PeekMessage (&message, NULL, 0, 0, PM_REMOVE) ) { 

if(!IsDialogMessage(hDlg, 技 message)) { 
TranslateMessage (&message); 

DispatchMessage (^message); 

} 

} 

return printOK ； // printOK 는 대 역변수이 다 . 


hDlg 에 는 인쇄일 감을 중지하는데 사용되 는 비양식 화대 화칸의 손잡이 를 설정한다. 
printOK 는 령 아닌 값으로 초기 화된 대 역 변수이 다. 사용자가 인쇄일 감을 중지 한 경 우 
는 이 변수에 령을 설정한다. 이 처리는 후에 설명하는 비양식화대화칸에서 진행한다. 

인쇄를 중지하는 대화칸 

중지함수를 작성하면 인쇄일감을 중지시키기 위한 비 양식화대화칸을 능동으로 하여 
야 한다. 이 대화칸에 다양한 기능이나 조종체를 추가할수도 있지만 최소한 인쇄일감을 
중지시키기 위한 [ Cancel ] 단추를 포함시켜야 한다. 

사용자가 [ Cancel ] 단추를 눌렀을 때 대화칸은 대역변수에 령을 설정한다. 이 대역 
변수는 앞절에서 설명한 중지함수의 돌림값으로 되여 있는것과 같아야 한다. 


완전한 인쇄실례프로그람 


실 례 17-3 에 보여 준 프로그람은 앞의 실 례프로그람에 중지 함수를 추가한것 이 다. 
그밖에 또 한가지 기 능도 추가되 였 다. 그것 은 확대 기 능이 다. 이 기 능을 사용하면 X 축과 
Y 축의 배률을 설정할수 있다. 체계설정배률은 1 로 되여 있으므로 확대되지 않는다. 이 
값을 1~10 의 범 위 에서 설정 할수 있 다. 이 배률을 사용하여 비 트매 프를 본래의 크기 의 
최 대 10배 까지 확대하여 인쇄할수 있 다. 한 방향만으로 확대할수도 있 다. 

배 률은 오르내 리 기 조종체 를 사용하여 설 정할수 있게 되 여 있 으므로 이 프로그람에 는 
COMCTL 32 .LIB 를 련결 하여 야 한다. 
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실례 17-3. Print 3 프로그람 

// 중지 함수와 확대 기능을 가진 실례 프로그람 

// 이 정의가 필요한 번역프로그람도 있다 . 
♦define WINVER 0x0500 


ttinclude 〈 windows. h> 
ttinclude <cstring> 
^include <commctrl. h> 
itinclude "print, h” 

ttdefine NUMLINES 25 
ttdefine SCALEMAX 10 


Mefine BMPWIDTH 256 
itdefine BMPHEIGHT 128 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM); 
BOOL CALLBACK EnlargeDialog (HWND, UINT, WPARAM, LPARAM) ； 
void Printlnit (PRINTDLGEX *printdlgex, HWND hwnd) ； 


BOOL CALLBACK AbortFunc(HDC hdc, int err); 

LRESULT CALLBACK KillPrint(HWND, UINT, WPARAM, LPARAM); 

char szWinName[] = ” My Win"; // 창문들라스의 이름 

int X = 0, Y = 0 ； // 현재 출력위 치 
int maxX, maxY ； // 화면의 크기 

HDC memDC, memPrDC ； // 가상장치손잡이 
HBITMAP hBit, hBit2, hlmage ； // 비트매프의 손잡이 
HBRUSH hBrush ； // 붓의 손잡이 


PRINTDLGEX printdlgex ； 
DOCINFO docinfo ； 
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HINSTANCE hlnst ； 

int Xenlarge = 1, Yenlarge = 1 ； 
int printOK = 1 ； 

HWND hDlg = NULL ； 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HACCEL hAccel ； 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl; 

INITCOMMONCONTROLSEX cc ； 


// 창문믈라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) : 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl.IpszClassName = szWinName; // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0 ； // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ； // 큰 아이콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC.ARROW) ； // 유표의 형 식 

wcl. IpszMenuName = M PrintDemoMenu3" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기억기령역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ； 


// 창문클라스를 등록한다 . 
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if( ! RegisterClassEx(&wcl)) return 0 ； 


/* 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Using the Printer", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결 정 하게 한다 . 
CW_USEDEFAULT, // 너 비는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

)； 


hlnst = hThisInst ； 

// 건반가속기를 적재한다. 

hAccel = LoadAccelerators(hThisInst, "PrintDemoMenu3") : 
// 비트매프를 적재한다. 

hlmage = LoadBitmap(hThisInst, "MyBPl") : 

// 공통조종체를 초기 화한다. 

cc.dwSize = sizeof (INITCOMMONCONTROLSEX) ; 
cc.dwICC = ICC_UPDO WN_CLASS : 

InitCommonControlsEx (&cc) : 


// 창문을 표시 한다. 

ShowWindow (hwnd, nWinMode); 
UpdateWindow (hwnd ); 


II 통보문순환고리를 작성한다. 
while(GetMessage(&msg, NULL, 0, 0)) 
{ 
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if( ! TranslateAccelerator(hwnd, hAccel, 技 msg)) { 
TranslateMessage(&msg) ； // 건반통보를 변환한다 . 
DispatchMessage(tosg) ; // Windows 2000 에 조종을 넘 긴다 . 

} 


return msg. wParam ； 

} 


/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 

PAINTSTRUCT ps ； 
int response ； 

TEXTMETRIC tm ； 
char str [250] ； 
int i ； 

unsigned copies ； 

double VidXPPI, VidYPPI, PrXPPI, PrYPPI ； 
double Xratio, Yratio ； 

RECT r ； 


switch (message) { 
case WM.CREATE ： 

// 화면의 크기를 엄는다 . 

maxX = GetSystemMetrics(SM_CXSCREEN) ； 

maxY = GetSystemMetrics(SM_CYSCREEN) ； 

// 가상창문을 작성한다 . 

hdc = GetDC(hwnd) ； 

memDC = CreateCompatibleDC(hdc) ； 

hBit = CreateCompatibleBitmap(hdc, maxX, maxY) ； 

SelectObject (memDC, hBit) ； 

hBrush = (HBRUSH) GetStockObject (WHITE_BRUSH); 
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SelectObject (memDC, hBrush) ； 

PatBlt(memDC, 0, 0, maxX, maxY, PATCOPY) ； 

ReleaseDC (hwnd, hdc); 
break； 

case WM.COMMAND： 
switch (LOWORD (wParam)) { 
case IDM_ENLARGE : 

DialogBox(hInst, ’’EnlargeDB”, hwnd, (DLGPROC) EnlargeDialog); 
break； 

case IDM.TEXT： // 본문을 인쇄 한다 . 

X = Y = 0； 


// PRINTDLGEX 구조체 를 초기화한다 . 
Printlnit (&printdlgex, hwnd) : 


if(PrintDlgEx(&printdlgex) != S_OK) break； 

else if(printdlgex.dwResultAc 仕 on != PD 一 RESULT 一 PRINT) break； 


docinfo. cbSize = sizeof (DOCINFO) ； 
docinfo.IpszDocName = ” Prin 仕 ng Text”; 
docinfo. IpszOutput = NULL; 
docinfo. IpszDatatype = NULL； 
docinfo. fwType = 0； 

StartDoc (printdlgex. hDC, &docinfo) ； 

strcpy(str, "This is printed on the printer.”); 

// 인쇄기의 본문치수를 엄는다 . 

GetTextMetrics(printdlgex. hDC, 射; m); 

printOK = 1； 

SetAbortProc (printdlgex. hDC, (ABORTPROC) AbortFunc); 

hDlg = CreateDialog(hInst, "PrCancel", hwnd, (DLGPROC) KillPrint) ； 

for(copies=0； copies < printdlgex. nCopies； copies++) { 

StartPage (printdlgex. hDC) ； 
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for(i=0 ； KNUMLINES ； i++) { 

TextOut(printdlgex. hDC, X, Y, str, strlen(str)) : 
// 개행한다 . 

Y = Y + tm. tmHeight + tm. tmExternalLeading ； 

} 


EndPage (printdlgex. hDC) ； 


lf(printOK) { 

Destroy Window (hDlg); 
EndDoc (printdlgex. hDC); 

} 


DeleteDC (printdlgex. hDC); 
break ； 

case IDM_BITMAP ： // 비트매프를 인쇄한다 . 

// PRINTDLGEX 구조체를 초기화한다 . 

Printlnit (&printdlgex, hwnd) ； 

if(PrintDlgEx(&printdlgex) != S 一 OK) break ； 

else if (printdlgex. dwResult Action != PD_RESULT_PRINT) break ； 


docinfo. cbSize = sizeof (DOCINFO) ； 
docinfo. IpszDocName = "Printing bitmaps" ； 
docinfo. IpszOutput = NULL; 
docinfo. IpszDatatype = NULL ； 
docinfo. fwType = 0 ； 


if (! (GetDeviceCaps (printdlgex. hDC, RASTERCAPS) 

& (RC.BITBLT | RC.STRETCHBLT))) { 
MessageBox(hwnd, "Cannot Print Raster Images”, 
"Error", MB_OK) ； 

break ； 

} 

// 인쇄기와 호환성 있는 기억기장치상황을 작성한다 . 
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memPrDC = CreateCompatibleDC(printdlgex.hDC) ; 

// 인쇄기 장치상황과 호환성 있는 비트매프를 작성 한다 . 

hBit2 = CreateCompatibleBitmap(printdlgex.hDC, maxX, maxY) ; 

SelectObject (memPrDC, hBit2); 


// 비트매프를 기 억기장치상황에 선택한다 . 


SelectObject (memDC, hlmage) : 


// 비트매프를 인쇄 기와 호환성 있는 장치상황에 복사한다 . 

BitBlt(memPrDC, 0, 0, BMPWIDTH, BMPHEIGHT, 
memDC, 0, 0, SRCCOPY); 

// ltoch 당 화소수를 얻는다 . 

VidXPPI = GetDeviceCaps (memDC, LOGPIXELSX) : 

VidYPPI = GetDeviceCaps (memDC, LOGPIXELSY); 

PrXPPI = GetDeviceCaps(printdlgex.hDC, LOGPIXELSX); 

PrYPPI = GetDeviceCaps (printdlgex. hDC, LOGPIXELSY) : 

// 배률을 얻는다 . 

Xratio = PrXPPI / VidXPPI ； 

Yratio = PrYPPI / VidYPPI ； 

SelectObject(memDC, hBit); // 가상창문에 보관한다 . 

StartDoc (printdlgex. hDC, &docinfo) : 
printOK = 1 ； 

SetAbortProc(printdlgex. hDC, (ABORTPROC) AbortFunc); 

hDlg = CreateDialog(hInst, "PrCancel", hwnd, (DLGPROC) KillPrint); 

for (copies=0 : copies < printdlgex. nCopies ； copies++) { 

StartPage (printdlgex. hDC); 


/* 적절한 배률이 아니라 임의의 배률로 

비 트매 프를 인쇄 기 장치 상황에 복사한다 . */ 
StretchBlt(printdlgex. hDC, 0, 0, 
BMPWIDTH * Xenlarge, 
BMPHEIGHT * Yenlarge, 
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memPrDC, 0, 0, BMPWIDTH, BMPHEIGHT, SRCCOPY); 


// 적절한 배률로 비트매프를 확대한다 . 

StretchBlt (printdlgex. hDC, 0, BMPHEIGHT+100*Yenlarge, 
(int) (BMPWIDTH*Xratio*Xenlarge), 

(int) (BMPHEIGHT*Yratio*Yenlarge), 
memPrDC, 0, 0, 

BMPWIDTH, BMPHEIGHT, 

SRCCOPY) ； 


EndPage (printdlgex. hDC) ； 


if (printOK) Destroy Window (hDlg) ； 


EndDoc (printdlgex. hDC) ； 

DeleteDC (printdlgex. hDC); 

DeleteDC (memPrDC) ； 
break ； 

case IDM.WINDOW ： // 창문의 내용을 인쇄한다 . 
GetClientRect (hwnd, &r) ； 
hdc = GetDC(hwnd); 

// 창문에 본문을 표시 한다 . 

GetTextMetrics (hdc, &tm) : 

X = Y = 0 ； 

strcpy(str, ” This is displayed in the main window.”); 
for(i=0 ； KNUMLINES ； i++) { 

TextOut(hdc, X, Y, str, strlen(str)) ； 

TextOut (memDC, X, Y, str, strlen(str)) ； 

// 개행한다 . 

Y = Y + tm. tmHeight + tm. tmExternalLeading ； 

} 

// 창문에 비트매프를 표시한다 . 

SelectObject (memDC, hlmage) : 

BitBlt(hdc, 100, 100, 256, 128, 

memDC, 0, 0, SRCCOPY) ； 
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// 다시그리기요구에 대처하기 위해 창문의 화상을 보관한다 . 
SelectObject (memDC, hBit) ； 

BitBlt(memDC, 0, 0, r. right, r. bottom, hdc, 0, 0, SRCCOPY); 

// 호환성 있는 장치상황을 작성한다 . 
memPrDC = CreateCompatibleDC(hdc) ; 

// 호환성 있는 비트매프를 작성한다 . 

hBit2 = CreateCompatibleBitmap (hdc, r. right, r. bottom) ； 
SelectObject (memPrDC, hBit2); 


// 인쇄를 위해 창문의 화상을 보관한다 . 
BitBlt (memPrDC, 0, 0, r. right, r. bottom, 
hdc, 0, 0, SRCCOPY) ； 

// PRINTDLGEX 구조체 률 초기 화한다 . 
Printlnit (&printdlgex, hwnd); 


if(PrintDlgEx(&printdlgex) != S_OK) break； 

else if(printdlgex.dwResultAction != PD_RESULT_PRINT) break； 


docinfo. cbSize = sizeof (DOCINFO) ； 
docinfo. IpszDocName = "Printing Window" ； 
docinfo. IpszOutput = NULL; 
docinfo. IpszDatatype = NULL； 
docinfo. fwType = 0； 

// linch 당 화소수률 얻는다 . 

VidXPPI = GetDeviceCaps (memDC, LOGPIXELSX) ； 
VidYPPI = GetDeviceCaps (memDC, LOGPIXELSY) ； 

PrXPPI = GetDeviceCaps (printdlgex. hDC, LOGPIXELSX) ； 
PrYPPI = GetDeviceCaps (printdlgex. hDC, LOGPIXELSY) ； 


// 배 률을 얻는다 . 

Xratio = PrXPPI / VidXPPI； 
Yratio = PrYPPI / VidYPPI； 


if (! (GetDeviceCaps (printdlgex. hDC, RASTERCAPS) 
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& RC_STRETCHBLT)) 

{ 

MessageBox(hwnd, "Cannot Print Raster Images", 

"Error", MB_OK); 

break； 

} 

StartDoc (printdlgex. hDC, &docinfo) ； 
printOK = 1； 

SetAbortProc (printdlgex. hDC, (ABORTPROC) AbortFunc) ； 

hDlg = CreateDialog(hInst, ” PrCancel”, hwnd, (DLGPROC) KillPrint); 

for (copies=0 ； copies < printdlgex. nCopies； copies++) { 

StartPage (printdlgex. hDC) ； 


StretchBlt (printdlgex. hDC, 0, 0, 

(int) (r. right*Xratio) * Xenlarge, 
(int) (r. bottom*Yratio) * Yenlarge, 
memPrDC, 0, 0, 

(int) r. right, (int) r. bottom, 
SRCCOPY) ； 


EndPage (printdlgex. hDC) ； 

} 


if (printOK) Destroy Window (hDlg) ； 

EndDoc (printdlgex. hDC) ； 

DeleteDC (printdlgex. hDC); 

DeleteDC (memPrDC) ； 

ReleaseDC (hwnd, hdc) ； 
break； 

case IDM.EXIT： 

response = MessageBox(hwnd, "Quit the Program?”, 
” Exit，，, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O); 
break； 
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case IDM_HELP： 

MessageBox(hwnd, "Printing Demo”, "Help”, MB_OK); 
break； 

} 

break； 

case WM.PAINT： // 다시그러 기요구를 처 리 한다. 
hdc = BeginPaint (hwnd, &ps) ； // 장치 상황을 얻 는다. 

BitBlt (hdc, ps. rcPaint. left, ps. rcPaint. top, 

ps. rcPaint. right-ps. rcPaint. left, // 너비 
ps. rcPaint. bottom-ps. rcPaint. top, // 높이 
memDC, 

ps. rcPaint. left, ps. rcPaint. top, 

SRCCOPY) ； 

EndPaint(hwnd, 技 ps); // 장치상황을 해제한다. 
break； 

case WM.DESTROY： // 프로그람을 끝낸다. 

DeleteDC (memDC) ； 

PostQuitMessage (0) ； 
break； 
default： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다. */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 


return 0； 

} 

// PRINTDLGEX 구조체의 초기화 

void Printlnit (PRINTDLGEX *printdlgex, HWND hwnd) 

{ 

printdlgex-MStructSize = sizeof (PRINTDLGEX) : 
printdlgex->hwndOwner = hwnd； 
printdlgex->hDevMode = NULL； 
printdlgex->hDevNames = NULL； 
printdlgex->hDC = NULL； 
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printdlgex->Flags = PD_RETURNDC | PD_NOSELECTION | 

PD_NOPAGENUMS | PD_HIDEPRINTTOFILE | 
PD_COLLATE | PD_NOPAGENUMS ； 
printdlgex->Flags2 = 0; 
printdlgex->ExclusionFlags = 0; 
printdlgex->nMinPage = 1; 
printdlgex-〉nMaxPage = 1； 
printdlgex->nCopies = 1; 
printdlgex->hlnstance = NULL； 
printdlgex-〉lpCallback = NULL； 
printdlgex -〉； nPropertyPages = 0; 
printdlgex->lphPropertyPages = NULL； 
printdlgex->nStartPage = ST ART_P AGE.GENER AL ； 
printdlgex -〉 dwResult Action = 0; 


printdlgex->lpPrintTemplateName = NULL； 

} 

// 배률을 설정하는 대화함수 

BOOL CALLBACK EnlargeDialog (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

static int tempX=l, tempY=l; 
static long temp； 

static HWND hEboxWndl, hEboxWnd2； 
static HWND udWndl, udWnd2； 
int low=l, high=SCALEMAX； 


switch (message) { 
case WMJNITDIALOG： 
hEboxWndl = GetDlgItem(hdwnd, IDD.EBl) ； 
hEboxWnd2 = GetDlgItem(hdwnd, IDD.EB2) ； 
udWndl = CreateUpDownControl ( 

WS_CHILD | WS.BORDER | WS.VISIBLE | 
UDS.SETBUDDYINT | UDS.ALIGNRIGHT, 
10, 10, 50, 50, 
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hdwnd, 

IDD.UD1, 

hlnst, 

hEboxWndl, 

SCALEMAX, 1, Xenlarge) ； 


udWnd2 = CreateUpDownControl ( 

WS_CHILD | WS_BORDER | WS.VISIBLE | 
UDS.SETBUDDYINT | UDS_ALIGNRIGHT, 
10, 10, 50, 50, 
hdwnd, 

IDD_UD2, 

hlnst, 

hEboxWnd2, 

SCALEMAX, 1, Yenlarge) ； 

tempX = Xenlarge; 
tempY = Yenlarge; 
return 1； 

case WM_VSCROLL： // 오르내 리 기조종체 를 처 리 한다. 
if (udWndl== (HWND) IParam) 
tempX = GetDlgItemInt(hdwnd, IDD.EB1, NULL, 1)； 
else if (udWnd2== (HWND) IParam) 
tempY = GetDlgltemlnt (hdwnd, IDD.EB2, NULL, 1)； 
return 1； 

case WM.COMMAND： 
switch (LOWORD (wParam)) { 
case IDOK: 

Xenlarge = tempX； 

Yenlarge = tempY ； 
case IDCANCEL： 

EndDialog (hdwnd, 0); 
return 1； 

} 

break； 
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// 인쇄중지함수 

BOOL CALLBACK AbortFunc(HDC hdc, int err) 

{ 

MSG message； 

while (PeekMessage (&message, NULL, 0, 0, PM_REMOVE)) { 
if(!IsDialogMessage(hDlg, ^message)) { 

TranslateMessage (&message); 

DispatchMessage (技 message); 

} 

} 

return printOK； 

} 

// 사용자가 인쇄처리를 중지시키게 한다. 

LRESULT CALLBACK KillPrint (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

switch (message) { 
case WM.COMMAND： 
switch (LOWORD (wParam)) { 
case IDCANCEL： 
printOK = 0； 

Destroy Window (hDlg); 
hDlg = NULL； 
return 1; 

} 

break； 

} 


return 0； 

} 

이 프로그람에서 사용되는 자원파일은 다음과 갈다. 
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ttinclude < windows. h> 
#include ” print, h” 


MyBPl BITMAP BP. BMP 


PrintDemoMenu3 MENU 

{ 


POPUP ” ^Printer Demo" 


MENUITEM 

MENUITEM 

MENUITEM 

MENUITEM 

MENUITEM 


” &Enlarge\tF2", IDM_ENLARGE 
"Print &Text\tF3 M , IDM.TEXT 
” Print ■map\tF4", IDM_BITMAP 
” Print &Window\tF5 M , IDM.WINDOW 
"E&xit \ tCtrl+X", IDM.EXIT 


} 

MENUITEM n &Help M , IDM.HELP 


PrintDemoMenu3 ACCELERATORS 

{ 

VK_F2, IDM—ENLARGE, VIRTKEY 
VK_F3, IDM_TEXT, VIRTKEY 
VK_F4, IDM.BITMAP, VIRTKEY 
VK_F5, IDM.WINDOW, VIRTKEY 
『X", IDM_EXIT 

} 

EnlargeDB DIALOGEX 10, 10, 97, 77 
CAPTION ” Enlarge Printer Output” 

STYLE WS.POPUP | WS.SYSMENU | WS.VISIBLE 

{ 

PUSHBUTTON "OK", IDOK, 10, 50, 30, 14 
PUSHBUTTON "Cancel", IDCANCEL, 55, 50, 30, 14 
LTEXT "X Scale Factor", IDD.TEXTl, 15, 1, 25, 20 
LTEXT "Y Scale Factor”, IDD.TEXT2, 60, 1, 25, 20 
EDITTEXT IDD.EB1, 15, 20, 20, 12, ES.LEFT | 
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WS_TABSTOP | WS_BORDER 
EDITTEXT IDD_EB2, 60, 20, 20, 12, ES_LEFT | 
WS_TABSTOP | WS_BORDER 

} 


PrCancel DIALOGEX 10, 10, 100, 40 
CAPTION "Printing" 

STYLE WS_CAPTION | WS_POPUP | WS_SYSMENU | WS_VISIBLE 
{ 

PUSHBUTTON "Cancel", IDCANCEL, 35, 12, 30, 14 

} 

프로그람의 실행결과를 그림 17-3 에 준다. 


X Scale Y Scale 

Factor Factor 



This is disp 
This is disp 
This is disp 
This is disp 


ayed in the main window. 


그림 17-3. 최종판 인쇄 실례프로그람의 실행결과 
기 - 확대대화칸， l - X 축을 두배로 확대한 인쇄결과 


자체로 해보기 


인쇄와 관련하여 더 알아 두어야 할 내용들은 대 단히 많다. 이 장을 마치면서 자체 
로 두가지 시험을 해볼것을 권고한다. 

우선 천연색화상을 인쇄해 보는것이다. 만일 흑백인쇄기를 사용하고 있다면 여러가 
지 색이 어떠한 흑백계조로 변환되는가를 확인해 볼수 있다. 

또한 인쇄할 폐지범위를 설정해 보아야 한다. 그를 위해서 본문파일의 내용을 인쇄 
하는 프로그람을 작성해 보는것이 좋을것이다. 사용자가 폐지범위를 설정하면 그 범위만 
을 인쇄한다. 
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이 장에 서 는 화면보호기 (Screen Saver) 와 체 계 자료기 지 (System Registry) 라는 두가 
지 항목을 취급한다. 량자간에 어떤 관계가 있는가 하는 의문을 가질수 있지만 간단한 화 
면보호기를 작성할 때도 체계자료기지의 기능이 필요하게 된다는것을 알게 될것이다. 왜 
냐하면 일반적 인 화면보호기 에서는 설정정 보를 체 계자료기지 에 보관해 야 하기때문이 다. 

이 설정정보는 화면보호기가 기동될 때 창조된다. Windows 2000 은 이러한 정보를 
설정하기 위한 적절한 장소로서 체계자료기지를 제공하고 있다. 화면보호기는 체계자료기 
지를 리용하는 응용프로그람으로서 규모가 작다. 이 장에서 화면보호기를 취급하는 리유 
는 그것이 체계자료기지를 리용하는 좋은 실례로 되기때문이다. 

화면보호기 는 Windows 2000 응용프로그람으로서 는 간단한것 이지 만 프로그람작성 자 
에게 있어서는 흥미진지한것이기도 하다. 모든 프로그람작성자들이 한번 작성해 보고 싶 
다고 생각하는 응용프로그람의 하나인것 이다. 

화면보호기는 변화되지 않는 화면에 대한 보호대책으로서 고안된것이나 오늘에 와서 
는 그의 역할이 달라졌다고 볼수 있다. 현재 화면보호기의 대 다수는 환영을 목적한 통보 
문，도형，기관이나 단체의 명칭 또는 특색 있는 동화상들을 표시하기 위한 목적으로 리 
용된 다. 

그에 대 응하여 체 계자료기지 라는 항목은 보다 현실적 인것 이 라고 할수 있으며 
Windows 2000 의 프로그람작성기술에서 가장 중요한것의 하나이다. 체계자료기지는 를 
퓨터 본체와 그 우에서 실행되는 쏘프트웨어의 상태 나 설정과 관련한 정보를 보관하는데 
리 용된 다. 체 계자료기 지 의 사용은 생 각보다 아주 간단하다. 

이 장에 서 는 두 종류의 간단한 화면보호기 를 작성한다. 첫 화면보호기 는 아무러 한 
설정도 할수 없는것 이 며 체 계자료기지도 리용하지 않는다. 이 프로그람의 목적 은 모든 
화면보호기에 공통되는 기초지식을 주기 위한것이다. 두번째 화면보호기는 일부 설정이 
가능한것 이 며 설 정 된 정 보를 체 계 자료기 지 에 보관한다. 

미리 말해 두지만 이 두개의 화면보호기들은 다 사람들의 눈을 끄는 요란한 출력을 
진행하지는 않는다. 이 프로그람들은 화면보호기의 작성에 필요되는 기술을 주기 위한것 
일뿐이다. 다만 프로그람작성자들이 앞으로 본격적인 화면보호기를 작성하기 위한 첫 걸 
음으로 될것 이 다. 

화면보호기의 기초지식 


화면보호기는 Windows 2000 응용프로그람가운데 서 가장 간단한것 의 하나일것 이 다. 
왜 냐하면 화면보호기 는 기 본창문을 작성 하지 않기 때 문이 다. 화면보호기 는 탁상면 (화면전 
체)을 창문으로 사용한다. 또한 화면보호기에서는 WinMain( ) 함수가 쓰이지 않으며 통 
보문순환고리도 필요 없다. 화면보호기를 작성하는데 필요한 함수는 세개뿐이다. 이 함 
수들중 두 함수는 자체내 에서 아무러 한 처 리를 진행 하지 않아도 무방하다. 
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화면보호기 를 작성 할 때 는 SCRNSAVE.H 를 포함시 키 고 SCRNSAVE.LIB 를 련결 
하여야 한다. 화면보호기용의 서고는 화면보호기에 필요되는 많은 기능들을 제공해 준다. 
그때문에 프로그람에 필요되는 함수가 세개만으로 된다. 화면보호기의 작성에 필요되는 
함수들을 상세 히 설명해 보자. 

화면보호기를 작성하는데 필요되는 세가지 함수 

모든 화면보호기에 필요되는 세가지 함수는 다음의 표와 같다. 




ScreenSaverProc ( ) 

화면보호기의 창문수속. 통보문을 접수하고 
그에 응답하는 처리를 진행 

ScreenSaverConf igureDialog () 

화면보호기설정을 위한 대화함수. 설정이 
펼요 없으면 함수본체가 비여 있어도 좋다. 

RegisterDialogClasses ( ) 

전용콜라스를 등록하는데 사용. 전용클라스 
를 사용하지 않으면 함수본체가 비여 있어도 
좋다. 



이 함수들의 이름은 Windows 2000 에서 규정되고 있는것이지만 화면보호기의 원천 
코드안에 함수본체를 써넣어 야 한다. (왜 냐하면 Win 32 에 의해 제 공되는 함수가 아니기 
때문이다.) 매 함수들의 기능을 상세하게 설명해 보자. 

ScreenSaverProc( ) 는 정문수속이 다. 아래 에 선언을 보여 주었 다. 


LRESULT WINAPI ScreenSaverProc (HWND hwnd , UINT message , 
WPARAM wParam , LPARAM IParam ) : 


이 함수에는 일반적인 창문수속에서와 같은 방법으로 통보문이 전송되여 온다. 다만 
중요 한 차이점이 하나 있 다. 함수가 통보 문을 처리 하지 않는 경우에는 
DefWindowProc ( ) 가 아 니 라 DefScreenSaverProc( 상 를 호 출 하 는 것 이 다 . 
ScreenSaverProc ( ) 의 hwnd 에 주어지는 창문의 손잡이는 화면전체의 손잡이 로 된다. 
이것은 탁상면의 손잡이 이다. 이 손잡이를 화면보호기 가 사용한다. 

ScreenSaverConfigureDialogC 화면보호기 의 설정 대 화칸의 대 화함수이 다. 아래 
에 선언을 보여 주었다. 


BOOL WINAPI ScreenSaverConfigureDialog (HWND hdwnd , 
UINT message , WPARAM wParam , 
LPARAM IParam ) : 
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설정이 필요 없는 화면보호기인 경우 이 함수의 내부에서 진행하여야 할 처리는 령 
을 돌려 주는것뿐이다. 설정대화칸을 필요로 하는 화면보호기의 경우는 대화칸을 자원파 
일로서 정의 하고 그것 에 DLG_SCRNSAVECONFIGURB 라는 ID 를 설정 하여 야 한다. 이 
ID 의 값은 SCRNSAVE.H 에 정의되 여 있다. 

RegisterDialogClasses ( 〉는 전용창문콜라스를 등록하는데 사용된 다, 아래 에 선언을 
보여 주었다. 

BOOL WINAPI RegisterDialogClasses (HANDLE hlnst ) : 

전용창문클라스를 사용하지 않는 화면보호기의 경우에 이 함수의 내부에서 해야 할 
처리는 령을 돌려 주는것뿐이다. 

이 미 설 명 한 것 처 럼 ScreenSaverProcC ) 에 서 처 리 하 지 않 는 통 보 문 은 
DefScreenSaverProc ( ，에 넘 긴다. DefScreenSaverProc ( 乂의 선언은 다음파 같다. 


LRESULT WINAPI DefScreenSaverProc(HWND hwnd , UINT message , 
WPARAM wParam , LPARAM IParam ) : 


화면보호기를 작성하는데 필요한 두개의 자원 

화면보호기에서는 아이콘과 문자렬의 두개 자원을 정의하여야 한다. 아이콘의 ID 는 
ID_APP 로 하여 야 한다. 이 아이 콘은 화면보호기 를 식 별하기 위한것 으로 된다. 

문자렬 자원의 ID 는 IDS_DESCRIPTION 으로 하여 야 한다. 이 문자렬은 화면보호 
기 를 설 명 하는것 이 므로 조종판 ( [Property of Screen ] 조종판) 에 서 선 택 가능한 화면 보호 
기의 목록에 표시된다. 문자렬의 길이는 24문자이하여야 한다. 

ID_APP 와 IDS_DESCRIPTION 은 SCRNSAVE . H 에 서 정 의 된다. 

문자렬자원은 자원파일내에서 ■ STTiWGrASL 요명령을 포함하여 정의된다. 다음에 일 
반적인 서식을 준다. 

STRINGTABLE 

{ 

ID 1 “ string ” 

ID 2 “ string ” 


Idn “ string ” 

} 
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ID 는 문자렬 을 식 별 하기 위한 식 별 자이 다. 프로그람은 이 ID 를 사용하여 문자렬 을 
참조한다. 문자렬 자원을 적재 하기 위 해서는 LoadString ( ) 을 사용한다. 화면보호기 자체 
는 IDS_DESCRIPTION 로 정의되는 문자렬을 화면보호기를 식별하는데 쓸수 없다. 이 
문자렬은 조종판안에서 화면보호기의 설명 으로서 만 리 용된다. 

이식과 관련한 요점 : Windows 95/98 에서는 IDS_DESCRIPTION 으로 정의되는 문자렬 
이 [Property of Screen ] 의 [Screen Saver ] 페지표쪽에 표시되지 않는다. 그대신에 화 
면 보 호 기 의 이 름 이 표 시 된 다 . Windows 2000 에 서 는 여 기 서 설 명 한 것 처 럼 
IDS_DESCRIPTION 이 정확히 동작한다. 


기타 프로그람작성기법 

SCRNSAVE.H 에서는 몇가지 대역변수가 선언되고 있다. 그가운데서 이 장을 설명 
함에 있어서 중요한것은 Mainlnstance 이다. 이 변수에는 화면보호기의 실체의 손잡이 
가 보관되 여 있다. 이 변수가 필 요한것 은 화면 보호기 에 서 창문을 작성할 때 이 다. 
SCRNSAVE.H 에서 선언되는 다른 대역변수들도 화면보호기를 작성하는데 리용된다. 

모든 화면보호기는 시계에 의해 동작한다. 시계에 설정된 시간간격이 경과할 때마다 
화면보호기 는 통보문을 받아 들이 고 화면의 표시 내 용을 갱 신한다. 화면보호 

기가 기동할 때 시계를 시동시키며 화면보호기가 완료할 때 시계를 정지시켜야 한다. (시 
계 에 대 해 서 는 제 6 장을 참고) 

화면보호기 의 프로그람을 번역 하면 그 확장자를 EXE 로부터 SCR 로 변경 하여 야 한 
다. 확장자를 변경한 화면보호기의 프로그람을 적 당한 등록부에 복사한다. 일반사용자들 
은 화면보호기 를 보관하는 등록부를 WINNT \ SYSTEM 32 로 하고 있 다 . ( 화면보호기 를 
보관하는 등록부를 확인하기 위한 가장 간단한 방법은 현재 체계에 설치되여 있는 화면 
보호기가 어느 등록부에 보관되여 있는가를 조사하는것 이 다.) 화면보호기의 확장자의 변 
경과 적 절한 등록부에 로의 복사가 완료되 면 조종판을 리용하여 새 로운 화면보호기를 선 
택할수 있다. 


최소화면보호기의 작성 


간단한 화면보호기를 작성해 보자. 이 화면보호기는 화면우를 이동하는 본문으로 통 
보문을 표시할뿐이 다. 아무러 한 설정 도 진행할수 없으며 ScreenSaverConfigure 
Dialog () 함수도 사용할수 없다. 그러나 화면보호기에 필요되는 기본적인 기능은 파악할 
수 있다. 
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최 소화면보호기 를 실 례 18-1 에 제 시한다. 

실 례 18-1. Scr 프로그람 

// 최소화면보호기 
ttinclude〈windows. h> 
ttinclude <scrnsave.h> 

// 화면에 표시되는 통보문 

char str [80] = "Screen Saver #1”; 

// 시계의 시간간격 
int delay = 200; 

// 화면보호기의 창문수속 

LRESULT WIN API ScreenSaverProc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

static HDC hdc; 

static unsigned int timer； 

static RECT scrdim； 

static SIZE size; 

static int X = 0, Y = 0； 

static HBRUSH hBlkBrush； 

static TEXTMETRIC tm； 

switch (message) { 
case WM_CREATE： 

timer = SetTimer(hwnd, 1, delay, NULL) ； 

hBlkBrush = (HBRUSH) GetStockObject(BLACK_BRUSH); 

break； 

case WM—ERASEBKGND: 
hdc = GetDC(hwnd) ； 

// 화면의 크기를 엄는다. 

GetClientRect (hwnd, &scrdim) ； 


// 화면을 소거한다. 
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SelectObject (hdc, hBlkBrush) : 

PatBlt(hdc, 0, 0, scrdim. right, scrdim. bottom, PATCOPY) ； 

// 문자렬의 너비와 높이를 얻어서 보관한다. 

GetTextMetrics (hdc, &tm) ； 

GetTextExtentPoint32 (hdc, str, strlen(str), &size) ； 

ReleaseDC (hwnd, hdc) ； 
break ； 

case WM.TIMER ： 
hdc = GetDC(hwnd) ； 

// 앞서 진행한 출력을 소거한다. 

SelectObject (hdc, hBlkBrush) ； 

PatBlt(hdc, X, Y, X + size.cx, Y + size.cy, PATCOPY) ； 

// 문자렬을 새로운 위치로 이동한다. 

X += 10 ； Y += 10; 

if(X > scrdim.right) X = 0; 

if(Y > scrdim.bottom) Y = 0 ； 


// 문자렬을 표시 한다. 

SetBkColor(hdc, RGB(0, 0, 0 ))； 

SetTextColor (hdc, RGB(0, 255, 255)) ； 

TextOutChdc, X, Y, str, strlen(str)) ； 

ReleaseDC (hwnd, hdc) ； 
break ； 

case WM_DESTROY ： 

KillTimer(hwnd, timer) ； 
break ； 
default : 

return DefScreenSaverProc (hwnd, message, wParam, IParam) ； 


return 0 ； 
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// 아무것도 하지 않는 대화함수 

BOOL WINAPI ScreenSaverConfigureDialog (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

return 0 ； 

} 

// 전용물라스를 등록한다. 

BOOL WINAPI RegisterDialogClasses (HANDLE hlnst) 

{ 

return 1 ； 

} 


이 화면보호기는 아래와 같은 자원파일을 필요로 한다. 

#include < windows. h> 
ttinclude <scrnsave. h> 


ID.APP ICON SCRICON. ICO 


STRINGTABLE 

{ 

IDS.DESCRIPTION M My Screen Saver #1" 

} 

이 자원파일을 작성하면 화면보호기의 아이콘도 작성하여야 한다. 적당히 설계한 아 
이 콘을 SCRICON . 1 C ◦ 라는 파일이름으로 보관해 둔다. 

최소화면보호기의 상세 

화면보호기가 기동하면 두개의 통보문이 발송된다. 최초의 통보문은 WM _ C 及 EATE 
이다. 이 통보문을 받았을 때 시계를 시동시키는것을 비롯한 화면보호기에 필요되는 초 
기 화처 리 를 진행한다. 이 실례프로그람에서는 시 계의 시 간간격 을 200 ms 로 설정 하고 있 
다. 그러므로 시계 로부터 화면보호기 에 Is 사이 에 5 회의 새 치기 가 걸린다. 이 실례 프로 
그람에서는 화면보호기의 초기화처리로서 검은색 붓을 얻는 조작도 진행되고 있다. 

다음으로 화면보호기 가 받는 통보문은 WM—ERASEBKGND 이 다. 이 통보문을 받았 
을 때 화면보호기는 화면전체를 소거하는 처리를 진행하여야 한다. 물론 화면전체를 소거하 
기 위한 방법은 한가지만이 아니 다. 실례프로그람에서 사용되는 방법은 화면의 크기를 얻고 
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검은색 붓을 선택하여 그 령역을 Pati ) lt () 를 리용하여 검은색으로 색칠하는것이다. hwnd 
에 탁상면의 손잡이가 전달되므로 GetClientRectC ) 는 화면전체의 크기를 돌려 준다. 

이 화면보호기 에 의해 표시되는 통보문의 내용은 고정적 인것 이므로 
WM_ERASEBKGND 를 받았을 때 통보문의 크기를 얻 어서 보관하는 처 리도 진행 되 고 
있 다. 

시계에 설정된 시간이 경과할 때마다 WM_TIMER 통보문이 화면보호기에 전송된다. 
통보문에 대한 응답으로서 화면보호기는 현재 표시되여 있는 통보문을 소거하고 나서 표 
시위치를 갱 신하여 다시 통보문을 표시한다. 

사용자가 건반을 누르든가 마우스를 이 동하면 화면보호기 는 竹乳己幻五57次 OF 통보문 
을 접수한다. 화면보호기는 시계를 정지하고 기타 완료처리를 하여야 한다. 

이 화면보호기 에서는 사용자가 설정할수 있는 항목이 나 전용창문클라스가 없으므로 
ScreenSaverConfigureDialog ( ) 및 RegisterDialogClasses ( ) 악 내 에서 는 아무런 처 리 
도 진행되지 않고 있다. 

첫 화면보호기의 문제점 

여기서 작성한 화면보호기는 기본적인 기법을 보여 주기 위한것이며 실제로 사용하 
기에는 그 기능이 불충분하다. 우선 화면에 표시되는 문자렬이 변경될수 없으며 시계의 
시간간격도 고정되여 있다. 이것들은 사용자의 의사에 따라 설정될수 있게 되여야 한다. 

다행히 이러한 기능들을 화면보호기에 추가하는것은 간단히 해결할수 있다. 다만 그 
러자면 약간한 문제점이 로출된다. 그것은 어디에 설정정보를 보관하겠는가 하는것이다. 
설정가능한 화면보호기로 만들자면 시계의 시간간격과 화면에 표시되는 통보문을 디스크 
상의 어느 위치에 보관해 두어야 한다. 

또한 화면보호기 가 기동될 때 이 설정 값들을 얻을수 있어 야 한다. 이 실례 프로그람 
에서는 설정정 보의 자료파일 에 보관하는것 도 가능하지 만 체 계자료기지를 사용하는것 이 
보다 우월한 해결책으로 된다. 


체계자료기지의 기초 


앞에서 본것처럼 어떤 설정이 가능한 프로그람에서는 설정된 정보를 보관하기 위한 
수단이 필요하게 된다. 

이전의 롬퓨터환경에서는 매개 프로그람이 설정정보를 보관하기 위한 독자적인 자료 
파일을 작성하고 있었다. 이러한 파일의 확장자는 CFG 나 DAT 등이였다. (이러한 파일 
은 점차 사용되지 않고 있지만 아직도 일부 찾아 볼수 있다.) 이러한 개별적인 접근은 
DOS 와 같은 조작체 계 에 는 맞는것 이 였지 만 Windows 와 같은 다중과제 조작체 계 에 는 맞 
지 않는다. 왜냐하면 두개이상의 프로그람이 같은 이름의 설정파일을 사용하게 되는 경 
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우도 있을수 있으며 그렇게 되면 충돌이 발생하기때문이다. 

이 문제 를 해결하기 위해서 초기의 Windows 에서는 프로그람의 초기화정보파일로 
서 INI 라는 확장자가 예 약되 여 있 었다. Windows 자체 에 도 초기 화파일 이 있 으며 
WIN.INI 라는 이름으로 되여 있었다. 매개 응용프로그람이 설정정보를 보관하기 위해 
WIN . INI 를 사용할수도 있으며 자체의 INI 파일을 작성하는것도 가능했다. 

INI 파일은 설정 정 보를 보관하는 역 할을 수행 하지 만 문제 를 완전히 해 결하지 는 못한 
다. 그 리유의 하나는 서로 다른 두개의 응용프로그람이 동일한 이름의 INI 파일을 사용 
하게 된다는 문제가 남아있기때문이 다. 

콤퓨터 에 몇 개의 응용프로그람이 설치된다면 대 단히 많은 INI 파일 이 존재하게 된다. 
한 프로그람이 체계에 다른 프로그람이 설치되였는가를 알아 볼 펼요가 있는 경우가 있 
다. 이때 INI 파일을 사용한다고 해서 그것을 쉽게 알아 볼수 있다는 담보로는 되지 못 
한다. 

Microsoft 는 설정 파일문제 를 해결하기 위 한 최종적 인 수단으로서 INI 파일과 작별하 
고 조작체 계 자료기 지 (간단히 체 계 자료기 지 - System Regis 1: ry ) 라는 완전히 새 로운 수법 을 
고안하였 다. 체 계 자료기 지의 일부 기 능은 Windows 3. 1 시 대 에서부터 지 원되 고 있었으 
나 Win 32 환경 용으로 확장되 였 다. Windows 2000 에 서 도 낡은 형 식 인 INI 파일을 지 원하 
지만 새 로 작성 하는 응용프로그람에서는 그의 설정정 보를 보관하기 위 해 체계자료기지 를 
리용해 야 한다. 

여러가지 리유로부터 흔히 체계자료기지는 그것의 사용과 리해가 어렵다고 생각하고 
있 다. 그러 나 이 것 은 오해 이 며 사실은 정 반대 이 다. 뒤 에 서 알게 되 겠지 만 체 계 자료기 지 
의 사용방법은 매우 간단하다. 몇 가지 API 함수의 기능을 파악하면 체 계 자료기지를 아무 
런 문제도 없이 사용할수 있다. 

이식과 관련한 요점 : 체계자료기지는 Windows 3.1 에서 거의 무시되였다. 대 다수의 
Windows 3.1 프로그람은 체계자료기지를 사용하지 않는다. 그러나 새로운 응용프로그람 
특히 Windows 2000 용으로 작성된 응용프로그람에서는 체계자료기지를 사용해야 한다. 
낡은 프로그람을 이식할 때는 체계자료기지를 사용할수 있도록 변경시켜야 한다. 


체계자료기지의 구조 

제계자료기지는 Windows 가 관리 하는 특수한 계층구조를 가진 자료기지 이며 정보를 
사용자, 기계 및 설치된 쏘프트웨어의 세 가지 로 분류하여 보관한다. 체계자료기지의 거 
의 모든 부분은 어떤 설정정 보를 보관하는데 사용된다. 체계자료기지 에 보관된 정 보는 2 
진수형식으로 되여 있다. 그러므로 체계자료기지의 내용을 변경하거나 참조하는 방법은 
두가지 밖에 없 다. 표준의 체 계 자료기 지 편집 기 인 REGEDIT 또는 REGEDIT 32 를 리 용하 
든가 체 계자료기 지 관리 용의 API 함수를 사용하는것 이 다. 본문편집 기 등으로는 체 계자료 
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기지를 편집할수 없다. 

체 계자료기 지 는 나무구조로 된 열쇠의 집 합이 다. 열쇠 는 나무의 마디 점 으로 된다. 
열쇠의 이름이 마디점의 이름으로 된다. 열쇠가 비여 있는 경우，새끼열쇠를 가지는 경 
우, 값을 가지는 경우가 있다. 이 값은 일반적으로 프로그람의 설정정보를 담고 있게 된 
다. 그러므로 체계자료기지의 리 용은 프로그람에서 열쇠를 작성 하고 그 열쇠의 값으로서 
설정정보를 보관하는것으로 된다. 

프로그람에서 이 설정정보가 펼요하게 되였을 때 열쇠를 검색하여 값을 읽어낸다. 
사용자가 설정정 보를 변경시키는 경우에는 프로그람이 새 로운 설정값을 체계자료기지 에 
써넣는다. 이렇게 체계자료기지의 사용방법은 아주 간단하다. 

내장열 소 I 

체계자료기지에는 내장열쇠 A 몇종류 있다. 이 열쇠들은 자체의 열쇠에 의한 새끼나 
무의 뿌리마디점으로 된다. 내장열쇠들의 이름을 아래에 보여 주었다. 


HKEY _ CLASSES_ROOT 

COM 에 서 사용되 는 정 보를 보관한다. 파일 의 
확장자와 응용프로그람들의 련관도 정의한다. 

HKEY CURRENT CONFIG 

현재 하드웨어의 설정정보를 보관한다. 

HKEY _ CURRENT_USER 

현재 사용자와 관련한 정보를 보관한다. 사 
용자가 사용하는 응용프로그람의 설정정보는 
보통 여기에 보관된다. 

HKEY _ LOCAL_MACHINE 

설치되여 있는 쏘프트웨어, 망설정 및 기타 체 
계준위의 하드웨 어 정보 등이 보관되 여 있다. 

HKEY—USERS 

기계를 사용하는 매 사용자의 정보를 보관한다. 

HKEY — DYN 一 DATA 

동적 성 능자료를 보관한다. (Windows 95/98 
에서만) 

HKEY _ PERFORMANCE_DATA 

동적성능 자료를 보관한다. (Windows 
NT /2000 에서만) 


이 열쇠들은 항상 열 린 상태 로 되 여 있으므로 응용프로그람들에서 곧 사용된다. 일 
반적 으로 이 열쇠들가운데 서 응용프로그람이 사용하는것은 두개뿐이 다. 하나는 기계 와 
관련한 체계 준위의 설정정보가 보관된 HKEY _ LOCAL _ MACHINE 이따 다른 한가지는 사 
용자와 관련 한 설정 정보가 보관된 HKEY _ CURRENT_USER 이다. 

일반적인 설치프로그람들은 HKEY _ LOCAL_MACHINE 밑에 열쇠를 작성하고 응용 
프로그람의 이름, 판번호 및 제작기관의 명칭을 보관한다. 응용프로그람과 관련한 기타 
정 보가 있 으면 HKEY _ LOCAL_MACHINE 에 보관하기 도 한다. 

HKEY _ CURRENT_USER 말 아 는 사용자에 의 해 선택 된 설정 정 보가 보관된 다. 프로 
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그람이 설 치될 때 이 설정정 보의 체 계설정값이 보관된다. 응용프로그람은 기동시 에 이 
설정정보를 참조한다. 화면보호기와 관련한 설정정보도 이 열쇠의 밑에 보관되게 된다. 

이 장에서 작성하는 화면보호기는 간단한 실례프로그람이므로 특수한 설치가 요구되 
지 않는다. 그러므로 HKEY _ LOCAL_MACHINE 은 사용하지 않는다. 이 열쇠를 사용 
하여 체 계 자료기 지 로부터 자료를 읽 고 쓰는 방법 은 HKEY _ CURRENT_USER 의 경 우와 
같다. 

내장열쇠밑에는 몇개의 표준적인 새끼열쇠가 있다. 실례로 HKEY _ CURRENT _ 
USER 의 밑에는 Software , Control Panel 및 Environment 등의 표준적 인 새끼열쇠가 
있 다. 

새 로운 프로그람의 설정정 보를 체 계자료기 지 에 추가할 때 HKEY _ CURRENT _ 
USER 의 새끼 열쇠 인 Software 의 아래 에 추가하는것 이 일 반적 이 다. 그러 나 화면보호기 
의 설정 정 보는 조종판에서 변경 하게 되 여 있으므로 새끼열쇠 인 Control Panel 의 밑 에 
보관한다. 표준적인 열쇠는 Windows 2000 이 동작하는 거의 모든 름퓨터에 존재하지만 
자동적으로 열리는것은 아니다. 

체 계 자료기 지 는 계 층적 인 나무구조로 되여 있 으므로 목적 하는 열쇠를 완전경 로로 지 정 
해야 한다. 열쇠의 경로는 등록부의 경로의 개념과 류사하다. 매개 열쇠는 그의 앞에 \ 기 
호를 배치하여 구별한다. 실례로 HKEY _ CURRENT _ U 況及와 새끼열쇠인 Control Panel 의 
밑에 있는 Screensaver 를 참조하는 경우에 다음과 같이 열쇠의 경로를 지정한다. 


HKEY _ CURRENT_USER \ Control Panel \ Screensaver 


열쇠의 이 름에 는 점 (.) 을 포함시 켜 도 무방하다. 

C / C ++ 에 서 는 문자렬 안에 서 쓰이 는 \기 호가 랄출순서 (Escape sequence ) 의 개 시 를 
의미하므로 주의 해 야 한다. ( VC ++ 프로그람에서 \기호를 포함하는 문자렬을 사용하는 경 
우에는 \기호를 두번 반복하여 쓴다. 실례로 우에서 본 경로를 C 八>+의 문자렬로 표시 
하려면 다음과 같이 서술해 야 한다. 

^ KEY . CURRENT . USER \\ Control Panel \\ Screensaver 5 ， 

\기호를 두번 반복하여 쓰지 않으면 체계자료기지용의 함수가 정확히 동작하지 않는다. 

체계자료기지에 보관되는 값 

체 계자료기지의 열쇠 에 보관되는 값에 는 몇 가지 자료형 이 있 다. 자료를 읽거 나 쓸 
때 는 이 름과 자료형 을 지 정하여 야 한다. 표 18-1 에 체 계 자료기지 에서 지 원하는 자료형 
을 준다. 체 계자료기지의 열쇠 에 값을 추가할 때 는 반드시 자료형 을 지정한다. 값의 자 
료형 을 자동적 으로 판단하는 기 능은 체 계자료기 지 에 없 다. 
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표 18-1. 체계자료기지에서 지원하는 자료형 


REG_BINARY 

임의의 2 진수자료를 지정하는데 사용 
되는 일반적인 자료형 

REG—DWORD 

부호 없는 긴 정수 

REG _ DWORD _ LITTLE_ENDIAN 

제 일 아래 byte 를 최 초에 보관하는 부 
호 없는 긴 옹근수 

이 형식은 Little endian 이 라고 한다. 

REG _ DWORD _ BIG_ENDIAN 

제 일 웃 byte 를 처 음에 보관하는 부호 
없는 긴 정수 

이 형 식 은 Big endian 이 라고 한다. 

REG EXPAND SZ 

전개전의 환경변수를 포함한 문자렬 

REG LINK 

유니 코드의 기 호련결 ( symbolic link ) 

REG _ MULTI_SZ 

문자렬의 배렬. 끝에 두개의 NULL 을 
배 치하여 야 한다. 

REG—NONE 

정의되지 않은 자료형 

REG—QWORD 

4배단어의 값 

REG _ QWORD _ LITTLE_ENDIAN 

제 일 아래 byte 를 최초에 보관하는 4 
배 단어의 값 

REG RESOURCE LIST 

장치구동기의 자원목록 

REG—SZ 

일 반적 인 NULL 완료문자렬 


열쇠의 작성과 열기 

모든 체 계 자료기 지조작은 열쇠를 여는것 으로부터 시 작한다. 이 미 설 명 한것 처럼 내장 
열쇠들은 항상 열려 져 있다. 그러므로 다른 열쇠를 열 때는 어느 한 내장열쇠를 출발위 
치 로서 지 정 하게 된다. 이 미 존재 하는 열쇠 를 열 자면 RegOpenKeyEx ( ) 를 사용한다. 
아래에 선언을 보여 주었다. 

LONG RegOpenKeyEx(HKEY hKey , LPCSTR SubKey , 

DWORD NotUsed , REGSAM Access , 

PHKEY Result ) : 
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hKey 에는 이미 열려 져 있는 열쇠를 설정한다. 이 열쇠는 어느 한 내장열쇠 로 될 
것이다. 이 열쇠로부터 열기하는 열쇠는 hKey 의 새끼열쇠이여야 한다. 새끼열쇠의 이 
름은 SubKey 에 설정 한다. NotUsed 는 예 약된것 으로서 령 을 설정 하여 야 한다. Access 
는 새끼 열쇠의 호출권을 결정 한다. 여기 에 설정하는 값은 표 18-2 에 표시한 값들의 조 
합으로 된다. Result 에 새끼열쇠의 손잡이가 돌려 진다. 이 함수는 호출이 성공하면 
ERROR_SUCCESS 를 돌려 준다. 호출이 실패 하면 오유코드를 돌려 준다. 지정된 열쇠 
가 존재하지 않을 때 는 오유로 된 다. 


표 18-2. 열쇠의 호출권을 가리키는 값 


KEY _ ALL_ACCESS 

모든 호출을 허가 — 

KEY CREATE LINK 

기 호련 결 (symbolic link ) 작성 을 허 가 

KEY CREATE SUB KEY 

새끼열쇠의 작성을 허가 

KEY ENUMERATE SUB KEYS 

새끼열쇠의 렬거를 허가 

KEY EXECUTE 

읽기를 허가 

KEY—NOTIFY 

변경에 대한 통지를 허가 

KEY QUERY VALUE 

새끼열쇠의 자료를 읽는것을 허가 

KEY_READ 

모든 읽 기조작을 허 가. 

key _ enumerate _ sub_keys 

| KEY_NOTIFY | KEY _ QUERRY_VA 
LUE 와 같다. 

KEY SET VALUE 

새끼열쇠의 자료의 써넣기를 허가 

KEY_WRITE 

모든 써넣기조작을 허가한다. 
KEY _ CREATE _ SUB_KEY 
| KEY _ SET_VALUE 와 같다. 


RegOpenKeyEx ( ) 열쇠 를 리 용하면 체 계자료기지의 열쇠 를 열수 있지 만 이 밖에 도 
흔히 사용되 는 함수로서 RegCreateKeyEx ( M 있 다. 이 함수는 두가지 목적 으로 사용 
된다. 기존열쇠를 열든가 지정된 열쇠가 존재하지 않는 경우에 새로 열쇠를 작성한다. 
아래에 선언을 준다. 

LONG RegCreatKeyEx (HKEY hKey , LPCSTR SubKey , 

DWORD NotUsed , LPSTR Class , 

DWORD How , REGSAM Access , 
LPSECURITY_ATTRIBUTES SecAttr , 

PHKEY Result , LPDWORD WhatHappened ) : 
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hKey 에 열려는 열쇠의 손잡이를 설정한다. SubKey 에는 열거나 작성하려는 새끼 
열쇠 의 이 름을 설정 한다. NotUsed 는 예 약된것 으로서 령 을 설정 하여 야 한다. Class 에 는 
열쇠의 클라스 또는 객체형의 지시자를 설정한다. 이 값은 열쇠를 작성할 때만 필요하게 
되며 임의의 문자렬을 설정할수 있다. 


REG _ OPTION_VOLATILE 

REG _ OPTION _ NON_VOLATILE 

REG _ OPTION _ BACKUP_RESTORE 


REG_OPTION_VOLATILE 을 설정한 경우에 열쇠는 일시적인것으로 되며 디스크에 
보관되지 않는다. 이 값은 콤퓨터의 전원을 끌 때 없어 지게 된 다. 
REG_OPTION_NON_VOLATILE 쫄 지정 한 경우 일시적 인 열쇠가 아니 라 디스크에 보관 
되는 열쇠가 작성된다. 이 값이 체계설정값이다. 

REG_OPTION_BACKUP_RESTOm 를 설정 한 경 우 예 비 보관 ( Backup ) 또는 수복 
( Restore ) 호출권이 지정된것 으로서 열쇠 가 작성된다. 이 경우에는 Access 파라메터를 
설정할 필요가 없다. 

SetAttr 에 는 열 쇠 의 보 안 서 술 자 (security descriptor ) 를 정 의 하 는 
SECURITY_ATTRIBUTES 구조錢 의 지 시 자를 설정 한다. 이 값이 NULL 인 경 우는 체 계 
설정의 안전서술자가 사용된다. 

Result 에는 작성되거나 열려 진 열쇠의 손잡이가 돌려 진다. WhatHappened 에는 
진행된 처려 내용이 돌려 진 다. 이 값은 새로 운 열쇠가 작성되면 
REG_CREATE_NEW_KEY 로 되며 기 존의 열쇠 가 열 기 되면 
REG_OPEN_EXISTING_KEY 로 된다. 

RegCreateKeyEx( 호출이 성 공하면 ERROR-SUCCESS 를 돌려 주며 실패 하면 
오유 코드를 돌려 준다. 

이식과 관련한 요점 : 체겨】자료기지와 관련 한 함수로서 이름끝에 Ex 가 불은것들은 
Windows 3.1 에서는 지원되지 않는다. RegCreateKeyEx () 등은 지원되지 않는다. 그 
대신에 낡은 응용프로그람들에서는 RegCreateKey( ) 가 사용된다. 낡은 응용프로그람을 
이식할 때는 낡은 함수들을 이름뒤에 Ex 가 불은 새 함수들로 변경해 야 한다. 


값의 보관 


열쇠를 열면 거기에 값을 보관할수 있 다. 그러자면 SetRegValueEx( ) 를 사용한다. 
선언은 다음과 갈다. 
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LONG RegSetValueEx(HKEY hKey , LPCSTR Name , 

DWORD NotUsed , DWORD DataType , 

CONST LPBYTE lpValue , DWORD SizeOfValue ) ; 
hKey 에 는 KEY _ SET _ VALUE 호 \ 호출권을 지정 하여 연 열쇠의 손잡이 를 설정 한다. 
Name 에는 값의 이름을 설정한다. 이 이름이 존재하지 않는 경우 새로 열쇠가 추가된다. 
NoOJsed 는 예 약된것이며 령을 설정하여야 한다. 

DataType 에는 보관하려는 자료의 형을 설정한다. 이 형은 표 18-1 에 표시한 값이 
여야 한다. lp Value 에는 보관하려는 자료의 지시자를 설정한다. SizeOfValue 에는 보관 
하려는 자료의 크기를 byte 단위로 설정한다. 문자렬자료의 경우는 문자렬끝기호도 계산 
된 다. 

아래 의 프로그람은 RegSetValueEx () 를 사용하여 StringTest 의 값으로서 “This is 
a test ” 라는 문자렬을 보관하는것 이 다. 

strcpy(str, “This is a test”) : 

RegSetValueEx(hRegKey, "StringTest", 0,REG_SZ, 

(LPBYTE) str, strlen(str)+l) : 

문자렬의 크기로서 종결기호 ( Nail ) 도 계산하므로 strlen ( ) 와 돌림값에 1 을 더해 준다. 
RegSetValueEx ( ) 는 호출이 성 공하면 ERROR-SUCCESS 를 돌려 주며 실패 하면 
오유 코드를 돌려 준다. 

값들 얻기 

체 계자료기지 에 값을 보관해 놓으면 임 의의 시 점 에서 프로그람(다른 프로그람도 포 
함) 에서 값을 얻을수 있 다. 그를 위 해 RegQueryValueEx () 함수를 사용한다. 아래 에 선 
언을 보여 주었다. 


LONG RegQueryValueEx (HKEY hKey , LPCSTR Name , 

LPDWORD NotUsed , LPDWORD DataType , 
LPBYTE Value , LPDWORD SizeOfData ) : 


hKey 에 KEY _ QUERY _ VALUE 꺅 호출권을 지정하여 열기한 열쇠의 손잡이를 설정 
한다. Name 에는 목적하는 값의 이름을 설정한다. 이 값은 지정된 열쇠에 존재하는 값 
이여야 한다. NcrtUsed 는 예약끝남이며 NULL 을 설정하여야 한다. 

DataType 에는 얻은 값의 자료형이 돌려 진다. 이것은 표 18-1 에 표시된 자료형으 
로 된다. Value 에는 지정된 값의 자료를 받는 완충기의 지시 자를 설정한다. SizeOfData 
에는 byte 단위의 완충기의 크기를 보관한 변수의 지시자를 설정한다. 함수를 호출하면 
실제 로 완충기 에 보관된 자료의 크기 가 SizeOfData 에 돌려 진다. 
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아래의 프로그람은 RegQuery V alueEx ( )를 사용하여 StringTest 의 값으로 되는 
문자렬 을 얻 는 프로그람이다. 

char str [80] ; 
long size = 80 ； 

RegQueryValueEx(hRegKey, “StringTest ”， NULL, REG_SZ, 

(LPBYTE) str, teize) : 

RegQueryValueEx ( ) 는 호출이 성공하면 ERROR_SUCCESS 를 돌려 주며 실패하 
면 오유코드를 돌려 준다. 

열소ᅵ의 닫기 

열쇠 를 닫기 위 해서는 RegCloseKey () 를 사용한다. 아래 에 선언을 보여 주었다. 
LONG RegCloseKey (HKEY hKey ) ; 

hKey 에 는 닫으려는 열쇠 의 손잡이 를 설정한다. 이 함수는 호출이 성 공하면 
ERROR_SUCCESS 를 돌려 주며 실패 하면 오유코드를 돌려 준다. 


|다시 한보 전진| 


기타 제계자료기지용함수 

이 장에 서 설 명하는 체 계자료기 지용의 함수는 화면 보호기 를 설정하는데 필 요 
한것 뿐이 다. 그밖에 도 체 계자료기 지 용의 함수가 여 러 개 있 다. 여 러 분들자신이 사 
용법을 알아 보시오. 자주 사용되는 함수들을 아래 에 보여 주었다. 


RegDeleteKey ( ) 

열쇠를 삭제한다. 

RegDeleteValueC ) 

값을 삭제한다. 

RegEnumKeyEx ( ) 

지정된 열쇠의 새끼열쇠를 렬거한다. 

RegEnumValue ( ) 

지정된 열쇠의 값을 렬거한다. 

RegLoadKey ( ) 

파일로부터 열쇠의 새끼나무를 적재한다. 

RegQuery Inf oKey ( ) 

지정된 열쇠의 상세정보를 얻는다. 

RegSaveKeyC ) 

지정된 열쇠의 새끼열쇠전체를 파일에 보관 
한다. 값도 보관된다. 


체 계자료기 지 에 대 해 보다 상세하게 학습하려 면 모든 열쇠 와 그의 값을 렬거 
하는 프로그람을 작성 해 보는것 이 좋다. 체 계자료기 지 를 조사할 때 는 함부로 값을 
변경하지 않도록 주의하여 야 한다. 름퓨터 가 동작하지 않게 될 수도 있 다. 
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제 18 장. 체 계자료기지의 리용법과 화면보호기의 작성 


REGE 미 T 의 사용법 

체 계자료기 지 용의 API 함수를 리 용하면 프로그람에 서 체 계 자료기 지 를 조작할수 있 다. 
또한 체 계 자료기 지 의 내 용을 알아 보거 나 변경 하려 면 REGEDIT 1는 REGEDT 32( 어 느 
것이나 다 체계자료기지편집기라고 부른다.)를 리용할수도 있다. 이 편집기들은 체계자 
료기지의 열쇠와 값을 표시한다. 열쇠와 값의 추가, 삭제 및 변경도 할수 있다. 

일 반적 으로는 수동적 으로 체 계자료기 지 를 변경 하지 말아야 한다. 약간한 변경 을 하 
여도 롬퓨터가 동작하지 않게 될수 있기때문이다. 그러나 체계자료기지편집기를 사용하 
여 체 계 자료기 지 의 구조나 내 용을 표시 하는데 한해 서 는 완전히 안전하다. 이 프로그람을 
리 용하여 체 계자료기 지 의 구체 적 인 구조를 리 해할수 있 다. 


설정가능한 화면보호기의 작성 


이 장에 서 맨 처 음 작성한 간단한 화면보호기 를 설정 가능한 프로그람으로 개 조하려 
면 세가지 기능을 추가하여야 한다. 

첫째 기 능은 화면보호기 의 자원파일 에 설정대 화칸을 정의하는것 이 다. 둘째 기 능은 
ScreenSaverConfigureDialog ( ) 함수에 처 리 를 서 술하는것 이 다. 세 번째 기 능은 설 정 정 
보를 체계자료기지에 보관하고 그것을 화면보호기의 기동시에 얻는것 이 다. 

이러한 기능들을 포함한 완전한 프로그람을 실례 18-2 에 보여 주었다. 이 프로그람에 
서는 돌리개조종제를 사용하고 있다. 그러므로 COMCTL 32 .LIB 를 련결할 필요가 있다. 

실 례 18-2. Scr 2 프로그람 

// 설정 가능한 화면보호기 
ttinclude 〈 windows. h> 

^include <scrnsave. h> 
ttinclude <commctrl. h> 
ttinclude <cstring> 

^include ” scr.h” 


ttdefine DELAYMAX 999 
ttdefine MSGSIZE 80 

// 화면에 표시할 통보문 

char str[MSGSIZE+l] = "Screen Saver #2 "； 


// 시계의 시간간격 
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long delay; 

unsigned long datatype, datasize ； 
unsigned long result ； 


// 체계자료기지의 열쇠 
HKEY hRegKey ； 

// 화면보호기의 창문수속 

LRESULT WIN API ScreenSaverProc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

static HDC hdc ； 

static unsigned int timer ； 

static RECT scrdim ； 

static SIZE size; 

static int X = 0, Y = 0 ； 

static HBRUSH hBlkBrush ； 

static TEXTMETRIC tm ； 


switch (message) { 
case WM.CREATE ： 

// 화면보호기용의 열쇠를 열거나 작성한다. 
RegCreateKeyEx(HKEY_CURRENT_USER, 

"Control Panel \\ Screen Saver.MyScrSaver”, 

0, "Screen Saver", 0, KEY_ALL_ACCESS, 

NULL, ^hRegKey, Result); 

// 열쇠가 작성된 경우 
if (result==REG_CREATED_NEW_KEY) { 

// 초기값을 보관한다. 
delay = 100; 

RegSetValueEx(hRegKey, ” delay' 0, 

REG 一 DWORD, (LPBYTE) &delay, sizeof (DWORD)) ； 
RegSetValueEx (hRegKey, "message", 0, 

REG_SZ, (LPBYTE) str, strlen(str)+l) ； 

} 

else { // 열쇠가 이미 존재하는 경우 
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// 시계의 시간간격을 얻는다. 
datasize = sizeof (DWORD) ； 

RegQueryValueEx(hRegKey, "delay", NULL, 
^datatype, (LPBYTE) 技 delay, Sdatasize) ； 

// 화면에 표시할 통보문을 얻는다. 
datasize = MSGSIZE ； 

RegQuery ValueEx (hRegKey, "message”, NULL, 
^datatype, (LPBYTE) str, &datasize) ； 

} 


RegCloseKey (hRegKey) ； 


timer = SetTimer (hwnd, 1, delay, NULL) ； 

hBlkBrush = (HBRUSH) GetStockObject(BLACK_BRUSH); 

break ； 

case WM.ERASEBKGND : 
hdc = GetDC(hwnd) ； 

// 화면의 크기를 엄는다. 

GetClientRect (hwnd, &scrdim) ； 

// 화면을 소거한다. 

SelectObject (hdc, hBlkBrush) ； 

PatBlt(hdc, 0, 0, scrdim. right, scrdim. bottom, PATCOPY) ； 

// 문자렬의 너비와 높이를 엄어서 보관한다. 

GetTextMetrics (hdc , 射 ; m) ； 

GetTextExtentPoint32 (hdc, str, strlen(str), &size); 

ReleaseDC(hwnd, hdc); 
break ； 

case WM—TIMER: 
hdc = GetDC(hwnd) ； 

// 이전 출력을 소거한다. 

SelectObject (hdc, hBlkBrush) : 

PatBlt(hdc, X, Y, X + size.cx, Y + size.cy, PATCOPY) ； 
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// 문자렬을 새로운 위치로 이동한다. 

X += 10 ； Y += 10; 

if(X > scrdim.right) X = 0; 

if(Y > scrdim.bottom) Y = 0 ； 

// 문자렬을 표시 한다. 

SetBkColor(hdc, RGB(0, 0, 0 ))； 

SetTextColor (hdc, RGB(0, 255, 255)) ； 

TextOutChdc, X, Y, str, strlen(str)); 

ReleaseDC (hwnd, hdc) ； 
break ； 

case WM_DESTROY ： 

KillTimer(hwnd, timer) ； 
break ； 
default : 

return DefScreenSaverProc (hwnd, message, wParam, IParam) ； 


return 0 ； 


// 설정을 진행하기 위한 대화함수 

BOOL WIN API ScreenSaverConf igureDialog (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

static HWND hEboxWnd ； 
static HWND udWnd ； 

switch (message) { 
case WMJNITDIALOG ： 

// 화면보호기용의 열쇠를 열거나 작성한다. 
RegCreateKeyEx(HKEY_CURRENT_USER, 

"Control Panel \\ Screen Saver. MyScrSaver", 

0, "Screen Saver", 0, KEY_ALL_ACCESS, 

NULL, &hRegKey, &result) ； 


720 


교육성 프로그람교육쎈터 



제 18 장. 체 계자료기지의 리용법과 화면보호기의 작성 


// 열쇠가 작성된 경우 
if (result==REG_CREATED_NEW_KEY) { 

// 초기값을 얻는다. 
delay = 100; 

RegSetValueEx(hRegKey, "delay", 0, 

REG.DWORD, (LPBYTE) &delay, sizeof (DWORD)) ； 

RegSetValueEx(hRegKey, "message”, 0, 

REG_SZ, (LPBYTE) str, strlen(str)+l) ； 

} 

else { // 열쇠가 이미 존재하는 경우 
// 시계의 시간간격을 엄는다. 
datasize = sizeof (DWORD) ； 

RegQueryValueEx(hRegKey, "delay”, NULL, 

技 datatype, (LPBYTE) &delay, &datasize) ； 

// 화면에 표시 할 통보문을 얻는다. 
datasize = MSGSIZE ； 

RegQuery ValueEx (hRegKey, "message”, NULL, 

^datatype, (LPBYTE) str, &datasize); 

} 

// 시계의 시간간격을 설정할 돌리개조종체를 작성한다. 
hEboxWnd = GetDlgltem (hdwnd, IDD_EB1) ； 
udWnd = CreateUpDownControl ( 

WS 一 CHILD | WS—BORDER | WS.VISIBLE | 

UDS.SETBUDDYINT | UDS.ALIGNRIGHT, 

20, 10, 50, 50, 
hdwnd, 

IDD.UPDOWN, 

hMainlnstance, 

hEboxWnd, 

DELAYMAX, 1, delay) ； 

// 현재의 통보문으로 편집 칸을 초기화한다. 

SetDlgltemText (hdwnd, IDD_EB2, str) ； 

return 1 ； 

case WM_COMMAND: 
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switch (LOWORD (wParam)) { 
case IDOK ： 

// 시계의 시간간격을 설정한다. 

delay = GetDlgltemlnt (hdwnd, IDD_EB1, NULL, 1): 

// 화면에 표시할 통보문을 얻는다. 

GetDlgltemText(hdwnd, IDD_EB2, str, MSGSIZE); 

// 체계자료기지를 갱신한다. 

RegSetValueEx(hRegKey , "delay", 0, 

REG_DWORD, (LPBYTE) &delay, sizeof(DWORD)) : 
RegSetValueEx (hRegKey, "message", 0, 

REG_SZ, (LPBYTE) str, strlen(str)+l); 

// 이대로 다음 case 문으로 넘어 간다. 
case IDCANCEL ： 

RegCloseKey (hRegKey); 

EndDialog (hdwnd, 0); 
return 1; 

} 

break ； 

} 

return 0 ； 

} 

// 전용물라스는 등록하지 않는다. 

BOOL WINAPI RegisterDialogClasses (HANDLE hlnst) 

{ 

return 1 ； 

} 

이 프로그람에 필요한 자원파일은 다음과 같다. 

// 화면보호기용의 대화칸 
ttinclude 〈 windows. h> 

#include <scrnsave. h> 

♦include "scr. h" 
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ID_APP ICON SCRICON. ICO 

STRINGTABLE 

{ 

IDS.DESCRIPTION "My Screen Saver #2” 

} 

DLG.SCRNSAVECONFIGURE DIALOGEX 18, 18, 110, 60 
CAPTION ” Set Screen Saver Options” 

STYLE DS.MODALFRAME | WS.POPUP | WS.VISIBLE | WS.CAPTION | 
WS.SYSMENU 

{ 

PUSHBUTTON "OK", IDOK, 20, 40, 30, 14 
PUSHBUTTON "Cancel", IDCANCEL, 60, 40, 30, 14 

EDITTEXT IDD.EB1, 5, 5, 24, 12, ES.LEFT | WS.TABSTOP | WS.BORDER 
EDITTEXT IDD.EB2, 5, 20, 65, 12, ES.LEFT | WS.TABSTOP | 

WS.BORDER | ES_AUTOHSCROLL 
LTEXT "Delay in milliseconds", IDD.TEXTl, 35, 7, 100, 12 
LTEXT "Message", IDD.TEXT2, 76, 22, 30, 12 

} 

머 리 부파일 SCR.H 의 내 용을 아래 에 준다. 


ttdefine IDD_EB1 200 

#define IDD_EB2 201 

ttdefine IDD_UPDOWN 202 

#define IDD_TEXT1 203 

ttdefine IDD.TEXT2 204 


설정가능한 화면보호기의 상세 

ScreenSaverConfigureDialog () 함수의 내용으로부터 설명을 시작해 보자. 이 대화 
함수에서는 시계의 시간간격과 화면에 표시되는 통보문의 두가지 항목을 설정할수 있다. 
아래에 다시 한번 프로그람 코드를 보여 주었다. 이 대화함수가 실행되면 그림 18-1 과 
갈은 대화칸이 표시된다. 
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그림 18-1. 화면보호기의 설정대화칸 


BOOL WIN API ScreenSaverConf igureDialog (HWND hdwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

static HWND hEboxWnd ； 
static HWND udWnd ； 

switch (message) { 
case WMJNITDIALOG ： 

// 화면보호기용의 열쇠를 열거나 작성한다. 
RegCreateKeyEx(HKEY_CURRENT_USER, 

” Control Panel \\ Screen Saver.MyScrSaver”, 

0, "Screen Saver", 0, KEY_ALL_ACCESS, 

NULL, &hRegKey, &result) ； 


// 열쇠가 작성된 경우 
if (result==REG_CREATED_NEW_KEY) { 

// 초기값을 보관한다. 
delay = 100; 

RegSetValueEx(hRegKey, ” delay”, 0, 

REG 一 DWORD, (LPBYTE) &delay, sizeof (DWORD)) ； 
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RegSetValueEx(hRegKey , "message”, 0, 

REG_SZ, (LPBYTE) str, strlen(str)+l) ； 

} 

else { // 열쇠가 이미 존재하는 경우 
// 시계의 시간간격을 엄는다. 
datasize = sizeof (DWORD) ； 

RegQueryValueEx(hRegKey, "delay”, NULL, 

技 datatype, (LPBYTE) &delay, &datasize) ； 

// 화면에 표시할 통보문을 얻는다. 
datasize = MSGSIZE ； 

RegQuery ValueEx (hRegKey, "message”, NULL, 
^datatype, (LPBYTE) str, &datasize); 

} 

// 시계의 시간간격을 설정할 돌리개조종체를 작성한다. 
hEboxWnd = GetDlgltem (hdwnd, IDD_EB1) ； 
udWnd = CreateUpDownControl ( 

WS.CHILD | WS.BORDER | WS.VISIBLE | 
UDS.SETBUDDYINT | UDS.ALIGNRIGHT, 
20, 10, 50, 50, 
hdwnd, 

IDD.UPDOWN, 

hMainlnstance, 

hEboxWnd, 

DELAYMAX, 1, delay) ； 

// 현재의 통보문으로 편집 칸을 초기화한다. 

SetDlgltemText (hdwnd, IDD_EB2, str) ； 

return 1 ； 

case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDOK: 

// 시계의 시간간격을 엄는다. 

delay = GetDlgItemInt(hdwnd, IDD_EB1, NULL, 1); 
// 화면에 표시 할 통보문을 엄는다. 
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GetDlgltemText(hdwnd, IDD_EB2, str, MSGSIZE) : 

// 체계자료기지를 갱신한다. 

RegSetValueEx(hRegKey , "delay", 0, 

REG_DWORD, (LPBYTE) &delay, sizeof (DWORD)) ； 
RegSetValueEx (hRegKey, "message", 0, 

REG_SZ, (LPBYTE) str, strlen(str)+l); 

// 이 상태로 다음 case 문으로 넘어 간다. 
case IDCANCEL ： 

RegCloseKey (hRegKey); 

EndDialog (hdwnd, 0); 
return 1; 

} 

break ； 


return 0 ； 

} 

대 화 칸 이 표시 되 면 WMJNITDIALOG 통보문을 받 아 들 인 다 . 이 때 대 화 칸은 
Screensaver . MyScrSaver 라는 체 계 자료 기 지 열 쇠 를 열 거 나 작성 한 다 . 이 열 쇠 는 
Control Panel 이라는 열쇠의 새끼 열쇠로 되여 있으며 Control Panel 은 
HKEY _ CURRENT_USER 라는 내장열쇠의 새끼열쇠로 되 여 있다. 그러므로 열거 나 작 
성하는 열쇠의 경로는 다음과 같이 된다. 


HKEY _ CURRENT_USER \ Control Panel \ Screen Saver . MyScrSaver 


이 미 설명한바와 같이 화면보호기 의 설정 은 조종판에 서 진행하므로 설정자료를 
Consol Panel 열쇠 의 아래 에 보관하는것 이 일반적 이 다. 체 계 자료기 지 에 열쇠가 존재 하 
지 않는 경우 (화면 보호기를 처음으로 기동 한 때는 존재 하지 않 는다.) 는 
RegCreateKeyEx ( 낫가 열쇠 를 작성 한다. 

열쇠 가 이 미 존재하는 경우는 열쇠 의 경 로가 열기된다. 이 프로그람에 의해 작성된 
체 계 자료기 지 의 경 로를 REGEDIT 에 서 표시 한것 을 그림 18-2 에 보여 주었 다. Windows 
2000 이 제 공하는 화면보호기 들도 표시되 여 있다. 

RegCreateKeyEx ( ) 의 호출이 완료되면 result 의 값을 조사하여 열쇠가 작성된것 
인가 아니면 이미 있던 열쇠가 열기된것인가를 확인한다. 열쇠가 작성된 경우는 시계의 
시간간격과 화면에 표시되는 통보문의 초기값을 보관한다. 그렇지 않은 경우에는 이 값 
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들을 체 계자료기 지 로부터 읽 어 낸 다. 

초기값을 얻으면 대화칸에 시계의 시간간격을 설정하는 돌리개조종체와 화면에 표시 
되 는 통보문을 설정하는 편집칸을 작성한다. 대 화칸에 는 두개 의 단추도 있 다. 사용자가 
[ OK ] 단추를 누른 경 우 돌리개 조종체 와 편집칸의 내 용을 리 용하여 체 계자료기 지 의 내 용 
을 갱신한다. 


그림 18 - 2 . 화면보호기에 의해 작성된 체계자료기지경로 

ScreenSaverProcO 안에서 WM_CREATE 통보문을 처리하는 부분을 설명하자. 여 
기에 서술된 코드는 대화칸에서 체계자료기지를 조작하는 부분과 완전히 동일하다. 물론 
사용자에 게 체 계자료기지 의 설정정 보를 표시하거 나 변경시키 게 하는것 이 아니 라 화면보 
호기의 동작을 조종하기 위해 설정정보를 사용한다. 

여기서 주의해야 할것은 사용자가 설정대화칸을 표시시키지 않고 화면보호기를 실행 
하는 경우도 있으므로 WM _ CREATE 통보문을 처리하는 코드에서도 열쇠의 작성과 값의 
설정 을 할수 있게 되 여 있다는것 이 다. 다시말하면 항상 체계 자료기지 에 Control Panel \ 
Screen Saver.MyScrSaver 라는 열쇠 가 존재 하며 delay 와 message 의 값이 있다고 가 
정 하여서 는 안된 다는것 이 다. 

자체로 해보기 

이 장의 목적 은 조작체 계 의 자료기 지 와 화면보호기 의 틀거 리 를 설 명 하는것 이 였 다. 
더 좋은 화면보호기를 작성하는것은 독자들에게 맡긴다. 화면전체크기의 비트매프를 작 
성하고 그것을 배경으로 사용하는것으로부터 시작하는것이 쉬울것이다. 물론 배경을 때 
때로 변화시키는것이 필요하다 . 그렇지 않으면 화면보호기로서의 목적을 상실하는것으로 
된다. 화상스캐너를 가지고 있다면 수자사진을 표시하여 간단하고 효과적 인 화면보호기 
를 작성할수 있다. 

이 장에 서 작성한 설정 가능한 화면보호기 는 실례프로그람이므로 체 계자료기 지 의 


뙤 n? l-ta 


== & ， 

^ EY' - APco nnnnnnaTl ldeJ 

iHKHK aa ᅳ S--..&...a® | 

Mya a &,$••. 


교육성 프로그람교육멘터 


727 













Windows 2000 프로그람작성 법 


HKEY_LOCAL_MACHINE 일사\ 밑 에 프로그람의 기 입 사항을 작성 할수 없 었 다. 보통 
규모가 큰 응용프로그람을 설치할 때는 설 치프로그람에 의해 HKEY_LOCAL_MACHINE 
의 아래 에 프로그람의 기 입사항이 작성 된 다. 

만일 화면보호기 와 그의 아이 콘을 설 치하는 자체 의 설 치프로그람을 작성한다면 
HKEY_LOCAL_MACHINE 의 아래 에 기 입 사항을 추가하는 처 리 를 진행 하여 야 한다. 
HKEY_LOCAL_MACHINE 꺅 아래에 응용프로그람의 정보를 추가한다면 다음과 같은 경 
로를 사용한다. 


HKEY _ LOCAL_MACHINE \ Software \ YourName \ AppName \ Version 


관심 을 돌려 야 할 또하나의 체 계 자료기 지 열쇠 는 HKEY_PERFORMANCE_DATA 이 
다. 이 열쇠는 두가지 점 에서 다른 내 장열쇠들과 다르다. 그것은 체 계자료기지 용의 함수 
를 사용하여 호출하여도 체계자료기지 에 정보가 보관되지 않는다는것 이 다. 또한 이 열쇠 
를 호출하여 현재 체 계안의 쏘프트웨어 의 성 능정 보를 엄 을수 있다는것 이 다. 이 열쇠 는 
응용프로그람을 최적화하는 경우에 활용할수 있다. 
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제 19 


차림표의 확장 


이 장에서는 Windows 프로그람의 가장 기본적인 요소의 하나인 차림 
표에 대한 설명으로 다시 돌아 간다. 제 4 장에서는 차림표의 기초적인 내 
용을 설명 하였 다. 이 장에 서 는 차림 표를 확장하는 방법 에 대 해 설명한다. 

Windows 의 차림표체계는 세련되고 고급한 기능들을 수많이 제공해 
준다. 이 장에 서 는 차림 표를 확장하기 위한 두가지 문제 를 취 급한다. 그것 
은 동적차림 표와 유동자림표。]다. 이 차림 표들은 응용프로그람의 차림 표의 
모양과 조작성 을 확장한다. 또한 WM _ MENURBUTTONUP 통1문을 처 리 
하는 방법 에 대 해서도 설명한다. 



Windows 2000 프로그람작성법 


동적차림표 


간단한 Windows 응용프로그람에서는 자원파일안에 정적인 차림표를 정의하는 경우 
가 일반적이지만 보다 고급한 응용프로그람에서는 프로그람의 실행시의 상황에 맞게 동 
적으로 차림표의 항목을 추가하거나 삭제해야 할 필요가 제기되는 경우도 있다. 

실례 로 문서 편집 기에서는 편집중의 파일의 상태 에 따라 [ File ] 차림 표의 표시 항목을 
변경하는 경우가 있다. 

프로그람의 실행시의 상황에 따라 상태가 변경되는 차림표를 동적차림표라1 한다. 
동적차림표를 사용하여 프로그람의 현재 상황에 맞게 사용자에게 적절한 차림 표항목을 
표시할수 있다. 

Windows 2000은 프로그람의 실행시에 차림표의 내용을 변경하기 위한 몇가지 API 
함수를 제공한다. 이 장의 실례 프로그람에서 사용되는 API 함수들은 InsertMenuItemC ), 
EnableMenuItem ( 人 DeleteMenuC 人 GetMenu ( ) 및 GetSubMenu ( /함수들이 다. 실례 
프로그람을 작성하기에 앞서 이 함수들부터 설명하기로 하자. 

차림표에 항목들 추가 

실행 시 에 차림 표의 항목을 추가하려 면 InsertMenuItein ( ) 을 리 용한다. 선언은 다음 
과 갈다. 


BOOL InsertMenuItem (HMENU hMenu , UINT Where , 

BOOL How , LPMENUITEMINFO Menulnfo ) : 


InsertMenuItem ( ) 에서는 hMenu 에 차림표의 손잡이를 설정하여 차림표항목을 추 
가한다. 새 차림표항목은 Where 로 지정한 항목의 앞에 삽입된다. Where 의 설정방법이 
How 에 표시된다. 

How 가 령 이 아닌 경우에는 Where 에 새 항목을 삽입하는 위 치를 가리키는 색 인을 
설정 한다. (색 인은 령 으로부터 시 작한다. ) How 가 령 인 경우에 는 Where 에 새 항목을 삽 
입할 위 치를 가리키는 기존항목의 ID 를 설정 한다. 

삽입 되 는 차림 표항목은 Menulnfo 가 가리 키는 MENUITEMINF ◦구조체、아 설정 한다. 
MENUITEMINF ◦子조錢 악 정의는 다음과 같다. 


typedef struct tagMENUITEMINFO 
{ 

UINT cbSize ； 

UINT fMask ； 

UINT fType; 
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UINT fState ； 

UINT wID ； 

HMENU hSubMenu ； 

HBITMAP hbmpChecked; 

HBITMAP hbmpUnchecked ； 

DWORD dwItemData ； 

LPSTR dwTypeData ； 

UINT cch ； 

HBITMAP hbmpltem ； // Windows 2000 및 Windows 98 이 후의 경 우에 만 
} MENUITEMINFO ； 


cbSize 에 는 MENUITEMINFO 구조체 의 크기 를 설정 한다. fMask 의 값은 차림 표의 
정 보를 설정 할 때 MENUITEMINFO 구조체 의 어 느 성 원에 유효한 값이 보관되 여 있는 
가를 가리키게 되여 있다. 이것은 능동으로 할 성원을 결정한다는것이다. (차림표의 정보 
를 얻을 때는 어느 성원에 유효한 정보가 들어 있는가를 가리킨다.) fMask 는 다음의 몇 
개 값의 조합으로 된다. 


MIIM_BITMAP 

hbmpltem (Windows 2000 및 Windows 98 이 후 
의 판에서만 리용) 

MIIM.CHECKMARKS 

hbmpChecked 및 hbmpUnchecked 

MIIM—DATA 

dwItemData 

MIIM 一 FTYPE 

fType (Windows 2000 및 Windows 98 이 후의 판 
에서만 리용) 

MIIM ID 

wID 

MIIM—STATE 

fState 

MIIM STRING 

dwTypeData (Windows 

MIIM SUBMENU 

hSubMenu 

MIIM.TYPE 

fType 및 dwTypeData (Windows 2000 에 서 는 
MIIM _ BITMAP , MIIM _ FTYPE , MIIM—STRING 
을 사용한다. 


차림 표항목의 종류는 fType 에서 설정한다. 이것은 다음의 몇 개 값들의 조합으로 
된 다. 
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fType 


MFT—BITMAP 

dwTypeData 의 아래 단어 에 비 트매 프의 손 
잡이를 설정한다. 차림표항목에 비트매프가 
표시된다. Windows 2000 에서는 fMask 에 
MIIM BITMAP 를 설정 한다. 

MFT_MENUBARBREAK 

차림표띠의 경우에는 항목을 새로운 행에 
표시 . 튀 여나오기 차림표인 경우에는 항목을 
다른 렬에 표시하고 띠를 사용하여 분할한 

다. 

MFT_MENUBREAK 

분할띠 가 사용되지 않는다.는것을 제외 하고 
는 MFT MENUBARBREAK 와 같다. 

MFT OWNERDRAW 

소유자그리기의 항목 

MFT_RADIOCHECK 

일반적인 차림표검사표식 이 아니라 단일선 
택단추로 항목을 선택한다. hbmpChecked 
에 NULL 을 설정하여 야 한다. 

MFT_RIGHTJUSTIFY 

항목을 오른쪽맞추기한다. 다른 항목도 오 
른쪽맞추기로 된다.(차림표띠의 경우에만) 

MFT—RIGHTORDER 

차림표가 오른쪽에서부터 왼쪽으로 표시된 
다. 오른쪽에서 왼쪽으로 쓰는 언어를 지원 
하기 위한 설정이다. 

MFT—SEPARATOR 

차림 표항목사이 에 가로구분선 을 긋는다. 
dwTypeData 와 cch 의 값은 무시된다. 이 
종류는 성원에는 설정되지 않는다. 

MFT—STRING 

dwTypeData 에 차림표항목을 가리키는 문 
자렬 의 지 시 자를 설 정 한다. Windows 2000 에 
서 는 fMask 에 MIIM STRING 을 설정 한다. 


fState 에는 차림표항목의 상태를 설정 한다. 이것은 다음의 값들의 조합으로 된다. 


MFS.CHECKED 

항목이 검사된 상태 

MFS.DEFAULT 

항목이 체계설정으로 설정된 상태 

MFS DISABLED 

항목이 무효한 상태 

MFS_ENABLED 

항목이 유효한 상태 (항목은 체계설정으로 유효한 
상태로 된다.) 

MFS—GRAYED 

항목이 무효한 상태에서 회색으로 표시된다. 

MFS-HILITE 

항목이 강조표시된 상태 
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MFS UNCHECKED 

항목이 검사되지 않은 상태 

MFS—UNHILITE 

항목이 강조표시되지 않은 상태 (항목은 체 계설정 
으로 밝게 표시되지 않은 상태로 된다.) 


wID 에 는 차림 표항목의 ID 를 설정 한다. 

튀 여 나오기 부분차림 표를 삽입 하는 경 우에 는 그의 손잡이 를 hSubMenu 에 설정 한다. 
그렇 지 않은 경 우에 는 hSubMenu 에 NULL 을 설정 한다. 

차림 표항목의 검 사상태 및 미 검 사상태 를 표시 하는 비 트매 프를 hbmpChecked 및 
hbmpUnchecked 에 설정할수 있다. 체계설정의 검사표식을 사용하는 경우에는 이 두개 
의 성 원에 NULL 을 설정한다. 

dwItemData 에 는 응용프로그람자체 의 자료를 설정할수 있 다. 이 성 원을 사용하지 
않은 경우는 령을 설정한다. 

차림 표에 정 보를 설정할 때는 dwTypeData 에 차림 표항목을 가리 키는 문자렬의 지 
시 자를 설정한다. 차림표정보를 엄을 때는 문자렬을 보관하기 위한 문자배 럴에 대 한 지 
시 자를 설정한다. 어 느 경 우에 나 dwTypeData 를 사용한다는것 을 알려 주기 위해 
fMask 에 MIIM_STRING 을 설정 하여 야 한다. 

차림표항목을 얻을 때 fMask 에 MIIM_STRING 이 설정되여 있는 경우는 cch 에 문 
자렬의 길이가 보관된다. 차림표항목을 설정할 때는 cch 의 값이 무시된다. 

차림표본문의 왼쪽에 표시될 비트매프를 지정하는 경우는 hbmpltem 에 비트매프의 
손잡이 를 설정 한다. fMask 에 는 MIIM—BITMAP 를 설정 하여 야 한다. 이 추가선택 항목은 
Windows 2000 에 새 롭게 추가된것 이 다. 

InsertMenuItem ( ) 은 호출이 성공하면 령이 아닌 값을 돌려 주고 실패하면 령을 돌 
려 준다. 


Windows 2000으 I 새로운 기능 : Windows 2000 에서는 차림표의 본문과 함께 비트매프 
를 설정할수 있다. 


이식과 관련한 요점 : InsertMenuItem ( )-& Windows 3.1 에서 지 원되지 않는 다. 
Windows 3.1 에서는 차림표를 동적으로 삽입하기 위 해 AppendMenu ( ) 또는 
InsertMenu ( ) 를 사 용 한 다 . 이 함 수 들 은 Windows 2000 에 서 도 지 원 하지 만 
InsertMenuItem ( 리용 할것을 권고 한다. 


차림표항목의 삭제 

차림 표항목을 삭제 하려 면 DeleteMenuC ) 항수를 사용한다. 선언은 다음과 같다. 
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BOOL DeleteMenu(HMENU hMenu , UINT ItemlD , UINT How ); 


hMenu 에 는 조작대 상으로 되 는 차림 표항목을 설정 한다. 삭제 할 항목을 ItemID 에 
설 정 한 다 . How 의 값 은 ItemID 의 설 정 방 법 을 가 리 키 게 된 다 . How 가 
MF-BYPOSITION 안 경 우 ItemID 에 삭제 할 항목의 색 인을 설정 한다. 

이 색인은 차림표에서 항목의 위치를 나타내는것이므로 선두의 차림표항목이 령으로 
된 다. How 가 MF—BYCOMMAND 인 경 우 ItemID 에 삭제할 항목의 ID 를 설 정한다. 
DeleteMenu ( ) 는 호출이 성공하면 령 이 아닌 값을 돌려 주며 실패하면 령을 돌려 준다. 

삭제 된 차림 표항목이 튀 여나오기부분차림 표의 항목인 경 우는 튀 여나오기부분차림 표 
의 파피도 진행된다. DestroyMenu( ) 를 호출할 필요는 없다. ( Des 分 ' oyAfem / O 에 대해서 
는 제 4 장에 서 설명 한다. ) 

차림표의 손잡이를 얻기 

차림 표항목을 추가하거 나 삭제하려 면 차림 표의 손잡이 가 필요하게 된다. 차림 표의 
손잡이를 얻으러면 GeM / eiit ， 삿함수를 사용한다. 선언은 다음과 같다. 


HMENU GetMenuCHWND hwnd ) : 


GetMenu ( ) 는 hwnd 로 지정된 창문의 차림표손잡이를 돌려 준다. 호출이 실패한 
경우에 NULL 을 돌려 준다. 

창문의 차림 표손잡이 를 엄 으면 GetSubMenuC 리 용하여 부분차림 표(튀 여 나 

오기차림 표)의 손잡이 를 얻 을수 있 다. 선언은 다음과 같다. 


HMENU GetSubMenu (HMENU hMenu , int ItemPos ); 


hMenu 에는 어미 차림표(기본차림표)의 손잡이를 설정한다. ItemPos 에는 목적하는 
튀여 나오기 차림표의 어미창문의 위 치를 설정한다. (선두의 위 치가 령으로 된다.) 이 함 
수는 호출이 성공하면 지정된 튀 여 나오기차림표의 손잡이를 돌려 주며 실패 하면 NULL 
을 돌려 준다. 

차림표의 항목수를 얻기 

동적으로 차림표를 작성할 때 차림표안의 항목수를 알고 싶은 경우가 있을것 이다. 차림 
표의 항목수를 얻자면 GetMenuItemCount ( 그함수를 사용한다. 선언은 다음과 같다. 


int GetMenuItemCount (HMENU hMenu ) : 
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hMenu 에는 목적하는 차림표의 손잡이를 설정한다. 이 함수는 호출이 성공하면 차 
림표의 항목수를 돌려 주며 실패하면 -1 을 돌려 준다. 

차림표항목몰 유효 훅은 무효로 하기 

특정한 상황에서만 유효한 상태로 하려는 차림표항목도 있을것이다. 이러한 경우에 
는 일시적으로 차림표항목을 무효로 하고 후에 그것을 유효로 전환시킨다. 이것을 실현 
하자면 EnableMenuItem ( 고함수를 사용한다. 선언은 다음과 같다. 


BOOL EnableMenuItem (HMENU hMenu , UINT ItemID , UINT How ) : 


hMenu 에 는 차림 표의 손잡이 를 설정한다. 유효 혹은 무효로 할 차림 표항목을 
ItemID 에 설정 한다. How 의 값은 두가지 용도로 쓰인다. 

첫 번째 용도는 ItemID 의 설 정 방법 을 지 적 하는것 이 다. How 가 MF_BYmSITIC>N 와 
경우는 Item_ID 에 차림표항목의 색인을 설정한다. 색인은 차림표에서 항목의 위치를 가 
리 키는것 이므로 선두의 차림표항목이 령 으로 된다. How 가 MF—BYCOMMAND 만 경우 
는 ItemID 에 차림 표항목의 ID 를 설정 한다. DeleteMenu ( ) 는 호출이 성공하면 령 이 아 
닌 값을 돌려 주며 실패하면 령을 돌려 준다. 

두번째 용도는 차림표항목을 유효 혹은 무효의 어느 상태로 할것인가를 설정하는것 
이다. 이것은 다음의 값으로 설정된다. 


MF DISABLED 

차림표항목을 무효로 한다. 

MF ENABLED 

차림 표항목을 유효로 한다. 

MF—GRAYED 

차림 표항목을 무효로 하고 회 색표시 


How 의 값을 설정 하기 위 해서는 두가지 용도의 기 발을 OR 연산자로 조합한다. 
EnableMenuItem ( ) 은 호출이 성공하면 항목의 직전 상태를 돌려 주며 실패하면 -1 
을 돌려 준다. 


|다시 한보 전진| 


GetMenultemlnfo( )와 SetMenultemlnfo( ) 

차림표의 상세한 정보를 얻거나 설정하려는 경우도 있을것이다. 그것을 위 
한 가장 간단한 방법 은 GetMenultemlnfo( 삿및 SetMenuItemlnfo ( )를 리 용하는 
것이다. 선언은 다음과 같다. 

BOOL GetMenuItemlnfo(HMENU hMenu , UINT ItemID , 
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BOOL How , LPMENUITEMINFO Menulnfo ) ; 

BOOL SetMenuItemlnfo (HMENU hMenu , UINT ItemID , 

BOOL How , LPMENUITEMINFO Menulnfo ); 

이 함수들은 차림 표항목의 상세 한 정 보를 얻 거 나 설정 하기 위한것 이 다. 대 
상으로 되는 차림 표항목을 가진 차림 표의 손잡이를 hMenu 에 설정 한다. 

차림 표항목을 ItemID 에 설정 한다. ItemID 의 설정 방법 은 How 에 서 지 시 된 
다. How 가 령 이 아닌 경우는 ItemID 에 항목의 색 인을 설정한다. How 가 령 
인 경 우에 는 ItemID 에 항목의 ID 를 설 정 한다. 

GetMenuItemInfo () 에 서 는 Menulnfo 가 가리 키 는 MENUITEMINFO 구조 
체에 항목의 현재 정보가 보관된다. SetMenuItemlnf0 ( ) 에서는 Menulnfo 가 
가리키는 구조체 에 차림표항목의 정보를 설정 한다. 

어느 함수나 호출이 성공하면 령이 아닌 값을 돌려 주며 실패하면 령을 돌 
려 준다. 상상할수 있는것처럼 SetMenuItemlnf0 ( )를 사용하면 차림표항목을 
유효 혹은 무효로 할수도 있다. 그러나 이러한 목적으로 SetMenuItemlnfo ( ) 
나 GetMenuItemlnfoC ) 을 사용하는것은 효률적이지 못하다. 차림표에 대한 구 
체적인 정보를 관리할 때만 이 함수들을 사용해야 합니다. 


차림표항목의 동적추가 


기본적인 차림표관리함수들에 대한 설명이 끝났으므로 이 함수들을 실제로 사용해 
보자. 우선 차림표항목을 동적으로 삽입하거나 삭제해 보자. 여기서는 기본창문에 여러 
가지 GDI 객체를 그리는 간단한 프로그람을 리용한다. 

이 프로그람에 는 두개 의 차림 표가 있 다. [ Options ] 차림 표와 [ Draw ] 차림 표이다. 
[ Options ] 차림 표는 사용자가 여 러 가지 추가선택 항목을 선택하도록 하기 위한것 이 다. 
[ Draw ] 차림표는 그러려는 객체를 사용자가 선택하도록 하기 위한것이다. 

실례 19-1 에 [ Options ] 차림표의 항목을 동적으로 추가하거나 삭제하는 실례프로그 
람을 보여 주었 다. WindowFunc ( ) 의 IDM_ADDITEM 및 IDM_DELITEM 의 case 문 
에 특히 주목하여야 한다. 이 부분에서 차림표항목의 추가와 삭제가 진행된다. 프로그람 
의 실행결과를 그림 19-1 에 주었다. 

실례 19-1. Menu 프로그람 
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// 이 정의가 필요한 번역프로그람도 있다. 
ttdefine WINVER 0x0500 


ttinclude〈windows. h> 


ttinclude <cstring> 
#include <cstdio> 
ttinclude "menu, h" 


LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
char szWinName[] = n MyWin，，; // 창문믈라스의 이름 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 

// 창문믈라스률 정의 한다. 
wcl.cbSize = sizeof (WNDCLASSEX) ； 


wcl.hlnstance = hThisInst； // 실체의 손잡이 
wcl. IpszClassName = szWinName； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ； // 큰 아이 콘 
wcl.hlconSm = NULL； // 큰 아이콘의 축소판을 사용한다. 
wcl.hCursor = LoadCursor(NULL, IDC.ARROW) ； // 유표의 형 식 

wcl. IpszMenuName = "DynMenu"; // 기본차림표 


wcl.cbClsExtra = 0； // 보조기억기령역은 필요 없다. 
wcl. cbWndExtra = 0； 
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// 창문의 배경색을 흰색으로 한다. 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 


// 창문물라스를 등록한다. 

if( ! RegisterClassEx(&wcl)) return 0； 


A 창문물라스가 등록되 였으므로 
창문을 작성할수 있다. */ 
hwnd = CreateWindow( 
szWinName, // 창문믈라스의 이름 
"Using Dynamic Memus", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다. 
CWJJSEDEFAULT, // X 자리 표는 Windows 가 결정 하게 한다. 
CW_USEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다. 
CWJJSEDEFAULT, // 너비는 Windows 가 결정하게 한다. 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다. 
NULL, // 어미창문은 없다. 

NULL, // 물라스차림표의 덧쓰기는 하지 않는다. 

hThisInst, // 실체의 손잡이 

NULL // 추가파라메터는 없다. 

)； 


// 건반가속기를 적재 한다. 

hAccel = LoadAccelerators(hThisInst, "DynMenu") : 

// 창문을 표시 한다. 

ShowWindow (hwnd, nWinMode) ; 

UpdateWindow (hwnd ); 


II 통보문순환고리를 작성 한다. 

while(GetMessage(&msg , NULL, 0, 0)) 

{ 

if (! TranslateAccelerator (hwnd, hAccel, &msg)) { 
TranslateMessage(&msg); // 건반통보를 변환한다. 
DispatchMessage(&msg) ; // Windows 2000 에 조종을 넘 긴 다. 

} 

} 


738 


교육성 프로그람교육쎈터 



제 19 장. 차림표의 확장 


return msg. wParam； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다. 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc； 

RECT rect； 

HMENU hmenu, hsubmenu； 
int response； 
int count； 

MENUITEMINFO milnfo； 


switch (message) { 
case WM.COMMAND ： 
switch (LOWORD (wParam)) { 
case IDM_ADDITEM ： // 동적으로 차림표항목을 추가한다. 
// 기본차림표의 손잡이를 얻는다. 
hmenu = GetMenu (hwnd) ； 

// 첫번째 튀 여 나오기 차림 표의 손잡이를 얻는다. 
hsubmenu = GetSubMenu (hmenu, 0); 

// 튀여나오기차림표의 항목수를 얻는다. 
count = GetMenuItemCount (hsubmenu) ； 

// 구분선을 추가한다. 

milnfo. cbSize = sizeof (MENUITEMINFO) ； 

milnfo. f Mask = MIIM.FTYPE ； 

milnfo. fType = MFT.SEPARATOR ； 

milnfo. f State = 0; 

milnfo. wID = 0 ； 

milnfo. hSubMenu = NULL ； 

milnfo. hbmpChecked = NULL ； 

milnfo. hbmpUnchecked = NULL ； 
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milnfo. dwItemData = 0； 
milnfo. dwTypeData = 0； 

InsertMenuItem (hsubmenu, count, 1, &miInfo) ； 

// 새 로운 차림 표항목을 추가한다. 
milnfo. fMask = MIIM.STRING | MIIM_ID； 
milnfo. wID = IDM.NEW； 

milnfo. dwTypeData = "E&rase (This is New Item) M 
InsertMenuItem (hsubmenu, count+1, 1, &miInfo) ； 

//「Add Item」 항목을 무효로 한다. 

EnableMenuItem (hsubmenu, IDM_ADDITEM, 

MF_BYCOMMAND | MF.GRAYED) ； 


//「Delete Item」 항목을 유효로 한다. 

EnableMenuItem(hsubmenu, IDM_DELITEM, 

MF_BYCOMMAND | MF_ENABLED); 

break； 

case IDM.DELITEM： // 동적으로 차림표항목을 삭제한다. 

// 기본차림표의 손잡이를 얻는다. 
hmenu = GetMenu (hwnd) ； 

// 첫번째 튀여 나오기 차림표의 손잡이를 엄는다. 
hsubmenu = GetSubMenu (hmenu, 0) ; 

// 새 차림표항목과 구분선을 삭제한다. 
count = GetMenuItemCount (hsubmenu) ； 

DeleteMenu(hsubmenu, count-1, MF_BYPOSITION | MF 一 GRAYED); 
DeleteMenu (hsubmenu, count-2, MF 一 BYPOSITION | MF_GRAYED) ； 

//「Add Item」 을 유효로 한다. 

EnableMenuItem (hsubmenu, IDM_ADDITEM, 

MF—BYCOMMAND | MF_ENABLED); 

// rDelete Item」 항목을 무효로 한다. 

EnableMenuItem (hsubmenu, IDM_DELITEM, 

MF_BYCOMMAND | MF_GRAYED); 
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case IDM.EXIT： 

response = MessageBox(hwnd, "Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O); 
break； 

case IDM_NEW： // 창문을 소거한다. 
hdc = GetDC(hwnd); 

GetClientRect (hwnd, &rect) ； 

SelectObject(hdc, GetStockObject (WHITE_BRUSH)) ； 
PatBlt (hdc, 0, 0, rect. right, rect. bottom, PATCOPY); 
ReleaseDC (hwnd, hdc) ； 
break； 

case IDM_LINES： 
hdc = GetDC(hwnd) ； 

MoveToEx(hdc, 10, 10, NULL) ； 

LineToChdc, 100, 100); 

LineToChdc, 100, 50)； 

LineTo(hdc, 50, 180)； 

ReleaseDC(hwnd, hdc); 
break； 

case IDM_ELLIPSES: 
hdc = GetDC(hwnd); 

Ellipse (hdc, 100, 100, 300, 200); 

Ellipse (hdc, 200, 100, 300, 200); 

ReleaseDC(hwnd, hdc); 
break； 

case IDM_RECTANGLES： 
hdc = GetDC(hwnd); 

Rectangle (hdc, 100, 100, 24, 260); 

Rectangle (hdc, 110, 120, 124, 170)； 

ReleaseDC (hwnd, hdc) ； 
break； 

case IDM_HELP: 

MessageBox(hwnd, "Try Adding a Menu Item", 

"Help", MB_OK) ； 

break； 

} 

break； 
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case WM_DESTROY： // 프로그람을 끝낸다. 

PostQuitMessage (0) ; 
break； 
default： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 에00 에 처 리를 맡긴다. */ 
return DefWindowProc(hwnd, message, wParam, IParam); 

} 

return 0； 

} 


이 프로그람은 아래의 자원파일을 필요로 한다. 

// 동적 차림 표 
#include〈windows. h> 

♦include "menu, h" 

DynMenu MENU 

{ 

POPUP "&Options" 

{ 

MENUITEM "&Add Item\tF2", IDM_ADDITEM 
MENUITEM "&Delete Item\tF3", IDM_DELITEM, GRAYED 
MENUITEM "E&xit\tCtrl+X", IDM_EXIT 

} 

POPUP "&Draw" 

{ 

MENUITEM "&Lines\tF4", IDM_LINES 
MENUITEM "&Ellipses\tF5", IDM_ELLIPSES 
MENUITEM "&Rectangles\tF6", IDM_RECTANGLES 

} 

MENUITEM "&Help", IDM_HELP 

} 

// 차림표의 가속기를 정의 
DynMenu ACCELERATORS 
{ 

VK_F2, IDM_ADDITEM, VIRTKEY 
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VK_F3, IDM.DELITEM, VIRTKEY 
VK_F4, IDM.LINES, VIRTKEY 
VK_F5, IDM_ELLIPSES, VIRTKEY 
VK_F6, IDM.RECTANGLES, VIRTKEY 
VK_F1, IDM.HELP, VIRTKEY 
『X", IDM_EXIT 

} 

머 리부파일 MENU.H 의 내용은 다음과 갈다. 여기 에는 이 장의 뒤부분에서 작성하 
는 두 프로그람에서 사용되는 값들도 포함되여 있다. 


ttdefine IDM.EXIT 100 

#define IDM.LINES 101 

Mefine IDM_ELLIPSES 102 

ttdefine IDM_RECTANGLES 103 

#define IDM.HELP 104 

ttdefine IDM.ADDITEM 200 

#define IDM.DELITEM 201 

ttdefine IDM.NEW 300 

#define IDM.NEW2 301 

#define IDM.NEW3 302 



그림 19-1. 차림표항목의 동적추가 
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동적차림표에 대한 첫 실례프로그람의 상세 

프로그람의 대 체적 인 부분들은 간단하므로 쉽 게 리 해할수 있다. 프로그람이 기동될 
때 [ Options ] 차림표에는 [Add Item ] , [Delete Item ] 및 [ Exit ] 라는 세개의 항목이 있다. 
초기 상태 에 서 는 [Delete Item ] 이 회 색 으로 표시 되 여 있 으므로 그것 을 선택 할수 없다. 

[ Erase ] 라는 차림 표항목을 추가하기 위 해서 [Add Item ] 을 선택 한다. 차림 표에 
[ Erase ] 가 동적 으로 추가되 면 [Delete Item ] 이 유효로 되 며 [Add Item ] 이 무효로 된다. 
[Delete Item ] 을 선택 하면 차림표로부터 [ Erase ] 가 삭제되고 [Add Item ] 이 다시 유효로 
되며 [Delete Item ] 이 본래의 무효상태 로 돌아 간다. 이 처 리 순서 에 의 해 새 로운 차림 표 
항목이 중복되여 추가되거 나 삭제되는것을 방지한다. 

IDM_ADDITEM 부분을 주의 깊 게 살펴 보자. [Op 仕 ons ] 라는 튀 여 나오기 차림 표의 
손잡이를 얻는 방법에 주목해 야 한다. 우선 GetMenu ( ) 를 리용하여 어미차림표의 손잡 
이를 엄어야 한다. 여기서는 프로그람의 기본차림표가 어미차림표로 된다. 

다음 GetSubMenu ( )를 사용하여 첫 번째 뒤 여 나오기차림 표의 손잡이 를 얻 는다. 이 
것은 [ Options ] 이다. 다음 차림표의 항목을 얻는다. 

이 실례프로그람에서는 차림표의 구조가 알려 져 있으므로 이 처리순서가 반드시 필 
요한것은 아니다. 그러나 실제 프로그람에서는 차림표의 구조가 알려 져 있지 않은 경우 
도 있으므로 이러한 순서를 보여 주고 있다. 마지막으로 차림표에 구분선과 [ Erase ] 항 
목을 추가하고 있다. 

프로그람의 선두에서 WINVER 라는 마크로에 0 x 0500 이라는 값을 정의하고 있는데 
주의해 야 한다. 이 마크로에 의 해 Windows 2000 에 새 로 추가된 머 리부파일의 정보가 
인용되게 된다. 이 정의를 하지 않으면 Windows 2000 혹은 Windows 98 에서만 유효한 
MIIM_STRING 과 같은 옹근수가 인용되 지 않는 번역프로그람도 있다. 

동적튀여나오기차림표의 작성 


이 미 있는 차림 표에 새 로운 항목을 추가하는것 만이 아니 라 튀 여나오기차림 표전체 를 
동적 으로 추가할수도 있다. (이것은 실행시 에 튀 여나오기차림표를 작성 한다는것 이 다.) 
먼저 차림 표를 작성 하고 다음 그것 을 이 미 있는 차림 표에 추가한다. 동적 튀 여나오기차림 
표를 작성 하려 면 CreatePopupMenu ( ) 타는 API 함수를 리 용한다. 선언은 다음과 같다. 


HMENU CreatePopupMenu ( ); 
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이 함수는 비여 있는 차림표를 작성하고 그의 손잡이를 돌려 준다. 
InsertMenuItem ( ) 을 리용하여 이 차림표에 항목을 추가한다. 차림표의 모든 항목이 추 
가되였으면 다시 InsertMenuItem ( ) 을 사용하여 그것을 이미 있는 차림표에 삽입한다. 

CreatePopupMenu ( )를 리 용하여 작성된 차림표는 후에 파피해 야 한다. 그러 나 차 
림표가 창문에 관련되 여 있는 경 우에 는 자동적 으로 파괴 된 다. 차림 표의 어 미차림 표가 
DeleteMenuC )로 삭제 될 때 도 자동적 으로 파피 된다. DestroyMenu ( )를 사용하면 동적 
차림표를 임의로 동적으로 파괴할수 있다. 

실례 19-2 의 프로그람은 앞의 실례 프로그람을 개조한것 이 다. 여 기서 는 [ Erase ] , 
[Black Pen ] 및 [Red Pen ] 이 라는 세개의 항목을 가진 튀 여 나오기 차림 표를 동적 으로 
작성 한다. [ Erase ] 를 선택 하면 창문의 내용이 삭제된다. [Black Pen ] 을 선택하면 검은 
색의 펜이 선택된다. (이것은 체계설정의 펜이 다.) [Red Pen ] 을 선택하면 붉은색의 펜이 
선택된다. 선택된 펜은 [ Draw ] 차림표에서 도형을 그릴 때 사용된다. 

이 프로그람에 서 는 튀 여나오기 차림 표의 작성 과 그것 을 [Op 吐 ons ] 차림 표에 추가하는 
방법에 주목하여 야 한다. 

실례 19-2. Menu 2 프로그람 


// 뭐여나오기차림표의 추가 

// 이 정의가 필요한 번역프로그람도 있다. 
ttdefine WINVER 0x0500 


^include < windows. h> 
itinclude <cstring> 
ttinclude <cstdio> 

^include ” menu, h" 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 

char szWinName[] = ” My Win"; // 창문들라스의 이름 

int WINAPI WinMain (HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 
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// 창문콜라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ; 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계 설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이론 
wcl. hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl. IpszMenuName = "DynPopUpMenu" : // 기본차림표 

wcl.cbClsExtra = 0 ； // 보조기 억기 령 역은 필요 없다 . 
wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 


// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


A 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow( 
szWinName, // 창문믈라스의 이름 
"Adding a Popup Menu", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자리 표는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 높이 는 Windows 가 결 정 하게 한다 . 
NULL, // 어미창문은 없다 . 

NULL, // 물라스차림표의 덧쓰기를 하지 않는다 . 

hThisInst, // 실체의 손잡이 

NULL // 추가파라메터는 없 다 . 
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// 건반가속기를 적재한다 . 

hAccel = LoadAccelerators (hThisInst, ” DynPopUpMenu”) ; 

// 창문을 표시 한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd) ； 

// 통보문순환고리를 작성 한다 . 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

if (! Translate Accelerator (hwnd, hAccel, 技 msg)) { 
TranslateMessage(&msg); // 건반통보를 변환한다 . 
DispatchMessage(&msg) ； // Windows 2000 에 조종을 넘 긴다 . 



return msg. wParam ； 

} 

/* 이 함수는 windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 

HMENU hmenu, hsubmenu ； 

RECT rect ； 

static HMENU hpopup ； 
int response; 
int count ； 

MENUITEMINFO milnfo ； 

static HPEN hCurrentPen, hRedPen; 


switch (message) { 
case WM_CREATE: 

// 붉은색의 펜을 작성한다 . 

hRedPen = CreatePen(PS_SOLID, 1, RGB (255, 0, 0)) ； 
// 검은색의 펜을 엄는다 . 
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hCurrentPen = (HPEN) GetStockObject(BLACK_PEN) ; 
break ； 

case WM.COMMAND ： 
switch (LOWORD (wParam)) { 

case IDM_ADDITEM ： // 동적으로 튀 여 나오기 차림표를 추가한다 . 
// 기본차림표의 손잡이를 엄는다 . 
hmenu = GetMenu (hwnd) ； 

// 첫번째 튀여나오기 차림표의 손잡이를 얻는다 . 
hsubmenu = GetSubMenu (hmenu, 0) ; 

// 튀 여 나오기 차림 표의 항목수를 얻 는다 . 
count = GetMenuItemCount (hsubmenu) ； 

// 새로운 튀 여 나오기 차림 표를 작성 한다 . 
hpopup = CreatePopupMenu ( ) ； 

// 동적 튀 여 나오기 차림 표에 항목을 추가한다 . 
milnfo.cbSize = sizeof (MENUITEMINFO) ； 
milnfo.fMask = MIIM.STRING | MIIMJD ； 
milnfo.wID = IDM.NEW ； 
milnfo. hSubMenu = NULL ； 
milnfo. hbmpChecked = NULL ； 
milnfo. hbmpUnchecked = NULL ； 
milnfo. dwItemData = 0 ； 
milnfo. dwTypeData = ” &Erase”; 

InsertMenuItem(hpopup, 0, 1, &miInfo); 

milnfo.dwTypeData = ” &Black Pen”; 
milnfo.wID = IDM.NEW2 ； 

InsertMenuItem (hpopup, 1, 1, toilnfo); 

milnfo.dwTypeData = "&Red Pen”; 
milnfo.wID = IDM.NEW3 ； 

InsertMenuItem (hpopup, 2, 1, &miInfo) ； 

// 구분선을 추가한다 . 

milnfo.cbSize = sizeof (MENUITEMINFO) ； 
milnfo.fMask = MIIM.FTYPE ； 
milnfo. f Type = MFT.SEPARATOR ； 
milnfo. f State = 0 ； 
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milnfo. wID = 0; 
milnfo. hSubMenu = NULL ； 
milnfo. hbmpChecked = NULL ； 
milnfo. hbmpUnchecked = NULL ； 
milnfo. dwItemData = 0 ； 

InsertMenuItem (hsubmenu, count, 1, &miInfo) ； 

// 기본차림표에 튀 여 나오기 차림표를 추가한다 . 
milnfo. fMask = MIIM.STRING | MIIM.SUBMENU ； 
milnfo. hSubMenu = hpopup ； 
milnfo.dwTypeData = ” &This is New Popup”; 

InsertMenuItem(hsubmenu, count+1, 1, 技 milnfo); 

//「Add Popup 」 항목을 무효로 한다 . 

EnableMenuItem (hsubmenu, IDM_ADDITEM, 

MF_BYCOMMAND | MF.GRAYED) ； 

//「Delete Popup 」 항목을 유효로 한다 . 

EnableMenuItem(hsubmenu, IDM_DELITEM, 

MF_BYCOMMAND | MF_ENABLED); 

break ； 

case IDM.DELITEM ： // 동적 으로 튀 여 나오기차림 표률 삭제 한다 . 

// 기본차림표의 손잡이를 얻는다 . 
hmenu = GetMenu (hwnd) ； 

// 첫번째 튀 여 나오기 차림표의 손잡이를 엄는다 . 
hsubmenu = GetSubMenu (hmenu, 0); 

// 새로운 튀 여 나오기 차림표와 구분선을 삭제 한다 . 
count = GetMenuItemCount (hsubmenu) ; 

DeleteMenu (hsubmenu, count-1, MF.BYPOSITION | MF_GRAYED) ； 
DeleteMenu(hsubmenu, count-2, MF.BYPOSITION | MF.GRAYED) ； 

//「Add Popup 」 을 유효로 한다 . 

EnableMenuItem (hsubmenu, IDM_ADDITEM, 

MF—BYCOMMAND | MF_ENABLED); 

// rDelete Popup 」 을 무효로 한다 . 

EnableMenuItem (hsubmenu, IDM_DELITEM, 

MF.BYCOMMAND | MF.GRAYED) ； 

break ； 
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case IDM.EXIT： 

response = MessageBox(hwnd, "Quit the Program?”, 

” Exit”, MB_YESNO); 
if (response == ID YES) PostQuitMessage(O) ； 
break； 

case IDM_NEW： // 창문을 소거한다. 
hdc = GetDC(hwnd); 

GetClientRect (hwnd, &rect) ； 

SelectObject(hdc, GetStockObject (WHITE.BRUSH)) ； 
PatBlt (hdc, 0, 0, rect. right, rect. bottom, PATCOPY); 
ReleaseDC(hwnd, hdc); 
break； 

case IDM.NEW2： // 검은색 펜을 선택한다. 
hCurrentPen = (HPEN) GetStockOb ject (BLACK.PEN) ； 
break； 

case IDM.NEW3： // 붉은색 펜을 선택 한다. 
hCurrentPen = hRedPen； 
break； 

case IDM_LINES： 
hdc = GetDC(hwnd) ； 

SelectObject (hdc, hCurrentPen) ； 

MoveToEx(hdc, 10, 10, NULL) ； 

LineToChdc, 100, 100)； 

LineTo(hdc, 100, 50)； 

LineToChdc, 50, 180)； 

ReleaseDC (hwnd, hdc) ； 
break； 

case IDM.ELLIPSES： 
hdc = GetDC(hwnd) ； 

SelectObject (hdc, hCurrentPen) ； 

Ellipse (hdc, 100, 100, 300, 200)； 

Ellipse (hdc, 200, 100, 300, 200); 

ReleaseDC(hwnd, hdc); 
break； 

case IDM.RECTANGLES : 
hdc = GetDC(hwnd); 

SelectObject (hdc, hCurrentPen) ； 

Rectangle (hdc, 100, 100, 24, 260) ； 
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Rectangle (hdc, 110, 120, 124, 170 )； 

ReleaseDC (hwnd, hdc) ； 
break ； 

case IDM_HELP ： 

MessageBox(hwnd, "Try Adding a Menu", ’’Help”, MB_OK) ； 
break ； 

} 

break ； 

case WM.DESTROY： // 프로그람을 끝낸다. 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처리를 맡긴다. */ 
return DefWindowProc(hwnd, message, wParam, IParam); 


이 프로그람은 앞의 실례프로그람과 같은 머 리부파일 MENU.H 를 사용한다. 그러 
나 자원파일은 아래에 준것을 사용한다. 


// 동적튀여나오기차림표 
ttinclude 〈 windows. h> 
#include "menu, h" 


DynPopUpMenu MENU 

{ 

POPUP "&Options" 

{ 

MENUITEM "&Add Popup \tF2", IDM_ADDITEM 
MENUITEM "&Delete Popup \tF3", IDM_DELITEM, GRAYED 
MENUITEM "E&xit\tCtrl+X", IDM_EXIT 

} 

POPUP "&Draw" 

{ 

MENUITEM "&Lines\tF4", IDM_LINES 
MENUITEM "&Ellipses\tF5", IDM_ELLIPSES 
MENUITEM "&Rectangles\tF6", IDM_RECTANGLES 
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} 

MENUITEM M &Help M , IDM.HELP 

} 

// 차림표의 가속기를 정의한다. 

DynPopUpMenu ACCELERATORS 

{ 

VK_F2, IDM_ADDITEM, VIRTKEY 
VK_F3, IDM_DELITEM, VIRTKEY 
VK_F4, IDM.LINES, VIRTKEY 
VK_F5, IDM_ELLIPSES, VIRTKEY 
VK_F6, IDM.RECTANGLES, VIRTKEY 
VK_F1, IDM.HELP, VIRTKEY 
『X", IDM_EXIT 

} 

프로그람의 실행 결과는 그림 19-2 에 보여 주었다. 



그림 19-2. 차림표항목의 동적추가 

프로그람의 다른 부분의 내용은 쉽게 리해할수 있다. 그러나 주의를 돌려야 할 부분 
도 있다. 그것은 MIIM_SUBMENU 기발아 설정되여 있다는것과 튀여 나오기 차림표를 차 
림 표에 삽입 할 때 그의 손잡이 를 hSubMenu 에 설정 하고 있는것 이 다. 
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|다시 한보 전진| 


자림표띠의 변경 

차림표에 항목을 추가하는것과 완전히 갈은 방법으로 차림표띠에 항목을 추 
가할수도 있다. 그러나 한가지 처리를 추가하여야 한다. 그것은 변경내용을 표시 
하기 위 해 차림 표띠 를 다시 그리 기 하는것 이 다. 그것 을 위 해 DrawMenuBar( ；# 
리용한다. 선언은 다음과 같다. 

BOOL DrawMenuBar (HWND hwnd ) : 

hwnd 에 차림표띠가 소속된 창문의 손잡이를 설정한다. 이 함수는 호출이 
성공하면 령이 아닌 값을 돌려 주며 실패하면 령을 돌려 준다. 

차림표띠내용을 변경 하는 시험을 목적 으로 튀 여나오기차림표의 실례프로그람 
에서 IDM_ADDITEM 부분을 다음의 프로그람코드로 치환한다. 

// 차림표띠 에 동적으로 뛰 여 나오기 차림표를 추가한다. 
case IDM_ADDITEM： 

// 차림표띠의 손잡이를 얻는다. 
hmenu = GetMenu(hwnd) : 

// 차림표띠의 항목수를 얻는다. 
count = GetMenuItemCount (hmenu) : 

// 새로운 튀 여나오기 차림표를 작성한다. 
hpopup = CreatePopupMenu ( ); 

// 동적 뭐 여 나오기 차림 표에 항목을 추가한다. 
milnfo. cbSize = sizeof (MENUITEMINFO) : 
milnfo. fMask = MIIM_STRING | MIIMJD； 
milnfo. wID = IDM_NEW； 
milnfo. hSubMenu = NULL； 
milnfo. hbmpChecked = NULL； 
milnfo. hbmpUnchecked = NULL； 
milnfo. dwItemData = 0； 
milnfo. dwTypeData = "SErase" : 

InsertMenuItem(hpopup, 0, 1, Smilnfo) : 

milnfo. dwTypeData = "SBlack Pen" : 
milnfo. wID = IDM_NEW2； 

InsertMenuItem (hpopup, 1, 1, toilnfo); 
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milnfo. dwTypeData = "&Red Pen" : 
milnfo.wID = IDM_NEW3 ； 

InsertMenuItem (hpopup, 2, 1, toilnfo); 

// 차림 표띠 에 튀 여 나오기 차림 표를 추가한다. 
milnfo. fMask = MIIM_STRING | MIIM_SUBMENU ； 
milnfo. hSubMenu = hpopup; 
milnfo. dwTypeData = "&New Popup" : 

InsertMenuItem (hmenu, count+1, 1, &miInfo); 

// 첫번째 튀 여나오기차림표의 손잡이를 얻는다. 
hsubmenu = GetSubMenu (hmenu , 0) : 

// 「Add Popup 」 항목을 무효로 한다. 

EnableMenuItem (hsubmenu, IDM_ADDITEM, MF_BYCOMMAND | 

MF_GRAYED) : 

// rDelete Popup 」 항목을 유효로 한다. 

EnableMenuItem (hsubmenu, IDM_DELITEM, MF_BYCOMMAND | 

MF_ENABLED) : 

// 차림표띠를 다시그리기한다. 

DrawMenuBar (hwnd) : 
break ； 

이 러한 변경을 진행하면 새 로운 튀 여나오기차림 표가 내 리펼침차림 표가 아니 
라 차림 표띠 에 추가된다. 같은 순서 로 IDM_DELITEM 부분에서 차림 표띠 로부터 
튀여나오기차림표를 삭제하는 프로그람코드도 작성해 볼수 있다. 새로운 튀여나 
오기차림 표가 추가된 차림 표띠 는 다음 그림 과 같다. 
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차림표띠의 내용을 변경시키려는 경우에는 개별적으로 변경을 진행할 대신 
SetMenuC ) 를 사용할 수도 있 다. SetMenuC ) 는 창문의 기 본차림 표전체 를 통채 로 
바꾸는 함수이다. 아래에 선언을 보여 주었다. 

BOOL SetMenuCHWND hwnd, HMENU hmenu) : 

hwnd 에는 대상으로 되는 창문의 손잡이를 설정 한다. hmenu 에는 새 로운 차 
림 표의 손잡이 를 설정 한다. 낡은 차림 표는 DestroyMenui 호출하여 파피 한 
다.응용프로그람에서 여 러개의 기 본차림 표를 사용할 필요가 있으면 그것들을 미 
리 작성해 두고 필요에 따라 SetMenu( )를 사용하여 차림표를 반전절환하는것 이 
합리적 이 다. 이 방법은 일반적 으로 차림표띠 를 일일 이 변경하는것보다 효률적 이 
다. 

기 본차림 표자체 를 동적 으로 작성하려 는 경 우는(이 것 은 차림 표띠인것 이 다. ) 
CreateMenuC ) 항속■를 사용한다. 선 언은 다음과 같다. 

HMENU CreateMenu( )； 

이 함수는 빈 차림 표의 손잡이 를 돌려 주므로 동적 뭐 여 나오기차림 표와 같은 
방법으로 차림표항목을 추가하여 야 한다. 


유동차림표의 사용방법 


고립형 (Stand alone) 의 유동차림표는 한때 Windows 프로그람작성 자들속에서 만 알 
려 져 있었으나 현재는 일반사용자들에게도 충분히 침투하여 그 중요성 이 증대되고 있다. 
이려한 리유의 하나로서 현재 모든 판본의 Windows 에서는 탁상면에서 마우스의 오른 
쪽 단추를 찰칵하면 유동차림표가 표시되도록 되 여 있다는 사실을 들수 있다. 

거의 모든 본격적 인 응용프로그람들에서는 유동차림표가 활용되고 있다. 유동차림표 
기 능을 지 원하지 않고서 는 최 신의 Windows 2000 프로그람을 작성 할수 없 다고 말해 도 과 
언이 아니다. 

유동차림표를 상황차림표나 지름차림표라고도 부론다. 이 책에서는 가장 일반적인 
호칭 인 유동차림표라는 표현을 사용하기로 한다. 

유동차림표의 표시 

유동차림 표를 표시 하려 면 TrackPo ! mpMenuEx ( ) 할수를 사용한다. 선언은 다음과 
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갈다. 

BOOL TrackPopupMenuEx(HMENU hMenu , UINT Flags , int X , int Y , 
HWND hwnd , LPTMPARMS OffLimits ) : 


hMenu 에 는 표시 하려 는 차림 표의 손잡이 를 설정 한다. 

Flags 에는 여 러 가지 추가선택항목을 설정 할수 있다. 이 파라메터 에는 표 19-1 에 보 
여 준 값을 조합하여 설정한다.(상반되는 의미를 가진 기 발들은 조합할수 없다.) 
Flags 에 령 을 설정할수도 있다. 령 인 경우에는 체 계 설정 이 리 용된다. 


표 19-1. TrackPopupMenuEx ( ) 의 Flags 파라메 터 의 값 


TPM-BOTTOMALIGN 

Y 를 하단으로 하여 유동차림 표를 표시 

TPM—CENTERALIGN 

표를 좌우의 중심으로 하여 유동차림표를 표시 

TPM_HORIZONTAL 

X , Y 로 지정된 위치에 차림표전체를 표시할 
수 없는 경 우는 수평 방향의 위 치설정 을 우선시 
한다. 

TPM_HORNEGANIMATION 

오른쪽에서 왼쪽으로 의 동화 효과를 사용 
(Windows 2000 및 Windows 98 에 서 만 ) 

TPM_HORPOSANIMATION 

왼쪽에서 오른쪽으로의 동화효과를 사용 
(Windows 2000 및 Windows 98 에 서 만 ) 

TPM.LEFTALIGN 

X 를 왼쪽 끝으로 하여 유동차림 표를 표시 (이 
것은 체계설정이다.) 

TPM.LEFTBUTTON 

마우스의 왼쪽 단추로 차림표항목을 선택 (이 
것은 체계설정 이다.) 

TPM_NOANIMATION 

동화효과를 사용하지 않음 ((Windows 2000 
및 Windows 98 에 서 만 ) 

TPM—NONOTIFY 

차림표는 통지문을 보내지 않는다. 

TPM.RETURNCMD 

선택 된 차림 표의 ID 가 돌려 진다. 

TPM RIGHTALIGN 

표 를 오른쪽 끝으로 유동차림표를 표시한다. 

TPM RIGHTBUTTON 

마우스의 오른쪽 단추로 차림표항목을 선택한다. 

TPM.TOPALIGN 

Y 를 상단으로 하여 유동차림표를 표시 (이것 
은 체계설정 이다.) 

TPM.VCENTRALIGN 

Y 를 아래우의 중심으로하여 유동차림표를 표시 

TPM.VERNEGANIMATION 

아래에서부터 우에로의 동화효과를 사용 
(Windows 2000 및 Windows 98 에 서 만) 
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TPM.VERPOSANIMATION 

우에서부터 아래로의 동화효과를 사용 
(Windows 2000 및 Windows 98 에 서 만) 

TPM_VERTICAL 

X , Y 로 지정된 위치에 차림표전체를 표시할수 
없는 경우 수직 방향의 위 치 설 정 을 우선시 한다. 


화면상에 차림표를 표시시키기 위한 위치를 X 와 Y 에 설정한다. 이 자리표는 화면 
단위로 되며 창문이나 대화칸의 단위가 아니다. 화면자리표와 창문자리표를 서로 변환하 
려 면 ClientToScreen ( ) 함수나 ScreenToClient ( ) 함수를 리 용한다. 체 계 설정 에서 는 
TmckPopupMenuEx ( ) 꺅 X， Y 를 왼쪽웃모서 리 의 자리 표로 하여 유동차림 표가 표시 된 
다. 그러 나 Flags 파라메터를 설정 하여 이 위 치를 변경 할수도 있다. 

TrackPopupMenuEx ( )를 호출하는 창문의 손잡이 를 hwnd 에 설 정 한다. 

유동차림표가 화면에 표시되는 령역을 제한할수도 있다. 그러자면 OffLimits 가 가 
리키는 TPMPARAMS 구조체에 령역범위를 설정한다. TPMPARAMS 구조체의 정의는 
다음과 갈다. 


typedef struct tagTPMPARAMS 
{ 

UINT cbSize ； 

RECT reExclude; 

} TPMPARAMS ； 

cbSize 에 는 TPMPARAMS 구조체 의 크기 를 설정 한다. rcExclude 에 는 제 외 시 키 는 
령역의 크기를 설정한다. rcExclude 에 설정하는 자리표는 화면단위로 한다. 화면에 표 
시 를 금지하는 령 역 이 없는 경우에는 OffLimits 에 NULL 을 설정한다. 

TrackPopupMenuEx ( ) 는 호출이 성 공하면 령 이 아닌 값을 돌려 주며 실패 하면 령 
을 돌려 준다. 그러나 Flags 에 TPM_RETURNCMD 가 설정되여 있는 경우에는 선택된 
차림표항목의 ID 가 돌려 진다. 이 경우에는 차림표항목이 선택되지 않았을 때 령이 돌 
려 진다. 


이식과 관련한 요점 : Windows 3.1 에 서 는 유 동 차 림 표 를 표 시 하 는 ^ J 
TrackPopupMenu () 함수가 사용되였다. 낡은 프로그람코드를 Windows 2000 에 이식하 
는 경우에는 이것을 TrackPopupMenuEx ( )로 치환하여야 한다. 

유동차림표의 실례 

실례 19-3 에 준 프로그람은 앞의 프로그람을 개조하여 [ Draw ] 차림표를 유동차림표 
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로 한것 이다. 그러므로 [ Draw ] 차림표는 차림표띠에 표시되지 않고 마우스의 오른쪽 단 
추를 누르면 표시된다. 유동차림표는 마우스의 단추를 눌렀을 때의 마우스 지시자의 위 
치 에 표시된다. 프로그람의 실행결과를 그림 19-3 에 보여 주었다. 

실 례 19-3. Menu 3 프로그람 

// 유동차림표 

// 이 정의가 필요한 번역프로그람도 있다 . 

#define WINVER 0x0500 
ttdefine _WIN32_WINNT 0x0500 


ttinclude 〈 windows. h> 

^include <cstring> 
ttinclude <cstdio> 
ttinclude "menu, h" 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) ； 
char szWinName[] = ，， MyWin”; // 창문클라스의 이름 
HINSTANCE hlnst ； 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

HACCEL hAccel ； 

// 창문믈라스를 정의 한다 . 
wcl.cbSize = sizeof (WNDCLASSEX) ； 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문들라스의 이름 
wcl.lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0 ； // 체계설정의 형식 
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wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION) ; // 큰 아이콘 
wcl.hlconSm = NULL； // 큰 아이콘의 축소판을 사용한다. 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 

wcl.IpszMemiName = "FloatMenu" : // 기본차림표 

wcl.cbClsExtra = 0； // 보조기 억기 령 역은 필요 없다. 
wcl. cbWndExtra = 0； 

// 창문의 배경색을 흰색으로 한다. 

wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) : 

// 창문콜라스를 등록한다. 

if( ! RegisterClassEx(&wcl)) return 0； 


/* 창문콜라스가 등록되 였으므로 
창문을 작성할수 있다. */ 
hwnd = CreateWindow ( 
szWinName, // 창문를라스의 이름 
"Using a Floating Popup Menu", // 제목 
WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다. 
CW_USEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다. 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다. 
CWJJSEDEFAULT, // 너 비는 Windows 가 결정 하게 한다. 
CW_USEDEFAULT, // 높이는 Windows 가 결정 하게 한다. 
NULL, // 어미창문은 없다. 

NULL, // 믈라스차림 표의 덧쓰기는 하지 않는다. 

hThisInst, // 실체의 손잡이 

NULL // 추가파라메 터 는 없 다. 

)； 


hlnst = hThisInst； // 실체의 손잡이를 보관한다. 

// 건반가속기를 적재 한다. 

hAccel = LoadAccelerators(hThisInst, "FloatMenu") : 


// 창문을 표시 한다. 
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ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd) ； 

// 통보문순환고리률 작성 한다. 

while(GetMessage (&msg, NULL, 0, 0)) 

{ 

if(! TranslateAccelerator(hwnd, hAccel, 技 msg)) { 
TranslateMessage(&msg) ； // 건반통보를 변환한다. 
DispatchMessage(&msg) ； // Windows 2000 에 조종을 넘 긴다. 

} 

} 

return msg. wParam； 

} 


/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다. 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc； 

HMENU hmenu, hsubmenu； 

RECT rect； 

static HMENU hpopup； 
int response; 
int count； 

MENUITEMINFO milnfo； 

POINT pt； 

static HPEN hCurrentPen, hRedPen； 


switch (message) { 
case WM_CREATE: 

// 붉은색 펜을 작성 한다. 

hRedPen = CreatePen(PS_SOLID, 1, RGB (255, 0, 0)) ； 
// 검은색 펜을 엄는다. 

hCurrentPen = (HPEN) GetStockObject(BLACK_PEN) ； 
break； 
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case WM.COMMAND ： 
switch (LOWORD (wParam)) { 

case IDM_ADDITEM ： // 동적으로 튀 여 나오기 차림표를 추가한다 . 
// 기본차림표의 손잡이를 얻는다 . 
hmenu = GetMenu (hwnd) ; 

// 첫번째 튀여나오기 차림표의 손잡이률 얻는다 . 
hsubmenu = GetSubMenu (hmenu, 0) ; 

// 튀여나오기 차림표의 항목수률 얻는다 . 
count = GetMenuItemCount (hsubmenu) ; 


// 새로운 튀여나오기차림표를 작성한다 . 
hpopup = CreatePopupMenu ( ); 

// 동적 튀 여 나오기 차림 표에 항목을 추가한다 . 
milnfo.cbSize = sizeof (MENUITEMINFO) ； 
milnfo.fMask = MIIM.STRING | MIIMJD ； 
milnfo.wID = IDM.NEW ； 
milnfo. hSubMenu = NULL ； 
milnfo. hbmpChecked = NULL ； 
milnfo. hbmpUnchecked = NULL ； 
milnfo. dwItemData = 0 ； 
milnfo. dwTypeData = ” &Erase”; 
InsertMenuItem(hpopup, 0, 1, &miInfo); 

milnfo.dwTypeData = M &Black Pen"; 
milnfo.wID = IDM.NEW2 ； 

InsertMenuItem (hpopup, 1, 1, &miInfo) ； 

milnfo.dwTypeData = ”&Red Pen"; 
milnfo.wID = IDM.NEW3 ； 

InsertMenuItem (hpopup, 2, 1, &milnf o) ； 

// 구분선을 추가한다 . 

milnfo.cbSize = sizeof (MENUITEMINFO) ； 
milnfo.fMask = MIIM.FTYPE ； 
milnfo. f Type = MFT.SEPARATOR ； 
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milnfo. f State = 0； 
milnfo. wID = 0； 
milnfo. hSubMenu = NULL； 
milnfo. hbmpChecked = NULL； 
milnfo. hbmpUnchecked = NULL； 
milnfo. dwItemData = 0； 

InsertMenuItem (hsubmenu, count, 1, &milnfo) ； 


// 기본차림표에 튀 여 나오기 차림표를 추가한다. 
milnfo. fMask = MIIM.STRING | MIIM.SUBMENU； 
milnfo. hSubMenu = hpopup ； 
milnfo.dwTypeData = M &This is New Popup”; 
InsertMenuItem(hsubmenu, count+1, 1, 技 milnfo); 

//「Add Popup」 항목을 무효로 한다. 
EnableMenuItem (hsubmenu, IDM_ADDITEM, 

MF.BYCOMMAND | MF.GRAYED) ； 


// rDelete PopupJ 항목을 유효로 한다. 

EnableMenuItem(hsubmenu, IDM—DELITEM, 

MF—BYCOMMAND | MF_ENABLED); 

break； 

case IDM.DELITEM： // 동적으로 튀 여 나오기 차림 표를 삭제 한다. 

// 기본차림표의 손잡이를 얻는다. 
hmenu = GetMenu (hwnd) ； 

// 첫번째 튀여나오기 차림표의 손잡이를 얻는다. 
hsubmenu = GetSubMenu (hmenu, 0) ; 

// 새로운 튀여 나오기 차림표와 구분선을 삭제한다. 
count = GetMenuItemCount (hsubmenu) ； 

DeleteMenu(hsubmenu, count-1, MF.BYPOSITION | MF 一 GRAYED); 
DeleteMenu (hsubmenu, count-2, MF 一 BYPOSITION | MF.GRAYED) ； 

//「Add Popup」 항목을 무효로 한다. 

EnableMenuItem (hsubmenu, IDM_ADDITEM, 

MF.BYCOMMAND | MF.ENABLED) ； 


// r Delete Popup J 항목을 유효로 한다 . 
EnableMenuItem (hsubmenu, IDM_DELITEM, 

교육성 프로그람교육쎈터 


762 



제 19 장. 차림표의 확장 


break ； 


MF_BYCOMMAND | MF_GRAYED) ; 


case IDM—EXIT: 

response = MessageBox (hwnd, "Quit the Program? M , 

” Exit”, MB.YESNO) ； 
if (response == ID YES) PostQu 仕 Message (0); 
break ； 

case IDM.NEW ： // 창문을 소거 한다 . 
hdc = GetDC(hwnd); 

GetClientRect (hwnd, &rect) ； 

SelectObject(hdc, GetStockObject (WHITE.BRUSH)); 
PatBlt(hdc, 0, 0, rect. right, rect. bottom, PATCOPY); 
ReleaseDC(hwnd, hdc); 
break ； 


case IDM_NEW2 ： // 검은색 펜을 선택한다 . 
hCurrentPen = (HPEN) GetStockOb ject (BLACK.PEN) ； 
break ； 


case IDM_NEW3 ： // 붉은색 펜을 선택한다 . 
hCurrentPen = hRedPen ； 


break ； 


case IDM_LINES: 
hdc = GetDC(hwnd); 
SelectObject (hdc, hCurrentPen) ； 
MoveToEx(hdc, 10, 10, NULL) : 
LineToChdc, 100, 100) ； 
LineToChdc, 100, 50 )； 
LineTo(hdc, 50, 180); 

ReleaseDC(hwnd, hdc); 
break ； 


case IDM_ELLIPSES: 
hdc = GetDC(hwnd); 
SelectObject (hdc, hCurrentPen) ； 
Ellipse (hdc, 100, 100, 300, 200); 
Ellipse (hdc, 200, 100, 300, 200 )； 
ReleaseDC(hwnd, hdc); 
break ； 


case IDM.RECTANGLES : 
hdc = GetDC(hwnd) ； 
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SelectObject (hdc, hCurrentPen) ； 

Rectangle (hdc, 100, 100, 24, 260); 

Rectangle (hdc, 110, 120, 124, 170); 

ReleaseDC (hwnd, hdc) ； 
break ； 

case IDM_HELP: 

MessageBox(hwnd, ” Try Pressing Right Mouse Button", 
” Help，，, MB_OK) ； 

break ； 

} 

break ； 

case WM.RBUTTONDOWN : // 유동차림표를 튀 여 나오기 시 킨다 . 

// 창문자러표를 화면자리표로 변환한다 . 
pt.x = LOWORD(lParam) ； 
pt.y = HIWORD(lParam) ； 

ClientToScreen (hwnd, &pt); 


// 「 Draw 」 차림표의 손잡이를 얻는다 . 
hmenu = LoadMenu(hlnst, "Draw”); 

// 첫번째 튀 여나오기 차림표의 손잡이를 얻는다 . 
hsubmenu = GetSubMenu (hmenu, 0); 

// 유동차림표를 표시한다 . 

TrackPopupMenuEx(hsubmenu, 0, pt.x, pt.y, 
hwnd, NULL) ； 

DestroyMenu (hmenu) ； 
break ； 

case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 

} 

return 0 ； 

} 
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이 프로그람은 앞의 프로그람과 같은 MENU.H 파일을 사용한다. 자원파일의 내용 
은 다음과 갈다. 

// 유동차림 표 
ttinclude 〈 windows. h> 

#include "menu, h" 

FloatMenu MENU 

{ 

POPUP "&Options" 

{ 

MENUITEM "&Add Popup \tF2", IDM_ADDITEM 
MENUITEM "SDelete Popup \tF3", IDM_DELITEM, GRAYED 
MENUITEM "E&xit\tCtrl+X", IDM_EXIT 

} 

MENUITEM "&Help", IDM_HELP 

} 

// 이 차림표가 유동차림표로 된다 . 

Draw MENU 

{ 

POPUP "&Draw" { 

MENUITEM "&Lines\tF4", IDM_LINES 
MENUITEM "&Ellipses\tF5", IDM_ELLIPSES 
MENUITEM "&Rectangles\tF6", IDM_RECTANGLES 

} 

} 

// 차림표의 가속기를 정의한다 . 

FloatMenu ACCELERATORS 

{ 

VK_F2, IDM_ADDITEM, VIRTKEY 
VK_F3, IDM_DELITEM, VIRTKEY 
VK_F4, IDM_LINES, VIRTKEY 
VK_F5, IDM_ELLIPSES, VIRTKEY 
VK_F6, IDM_RECTANGLES, VIRTKEY 
VK_F1, IDM_HELP, VIRTKEY 
"'-X", IDM_EXIT 

} 
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이 프로그람의 자원파일에서는 [ Draw ] 차림표가 기본차림표띠의 항목으로 되여 있 
지 않다는 사실에 주의를 돌려야 한다. [ Draw ] 차림표는 독립적 인 차림표로서 정의되 여 
있다. 그러므로 차림표가 호출될 때까지 표시되지 않는다. 

유동차림표프로그람의 상세 

프로그람의 대 체적 인 부분은 앞의 실례 프로그람과 같다. 단지 
WM_RBUTTONDOWN 부분의 프로그람코드에 주의 를 돌러 면 된 다. 이 부분에 서 
[ Draw ] 차림 표를 기 동하고 있 다. 아래 에 다시 한번 프로그람코드를 보여 주었 다. 

case WM_RBUTTONDOWN : // 유동차림 표를 뛰 여 나오게 한다 . 

// 창문자리표를 화면자리표로 변환한다 . 
pt.x = LOWORD(lParam) : 
pt.y = HIWORD(lParam) : 

ClientToScreen (hwnd, &pt) : 

// 「 Draw 」 차림표의 손잡이를 얻는다 . 
hmenu = LoadMenu(hlnst, "Draw") : 

// 첫 번째 튀 여 나오기차림 표의 손잡이 를 얻는다 . 
hsubmenu = GetSubMenu (hmenu, 0) : 

// 유동차림표를 표시한다 . 

TrackPopupMenuEx(hsubmenu, 0, pt.x, pt.y, 
hwnd, NULL); 
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DestroyMenu (hmenu) ; 
break ； 

이 프로그람코드는 마우스의 오른쪽 단추가 눌리웠을 때의 마우스지시자의 위치를 
왼쪽 웃모서 리 의 자리표로 하여 [ Draw ] 차림 표를 튀 여나오기시 킨다. 그런 데 
TrackPopupMenuEx ( M 入'는 화면 단위 가 사용되 므로 ClientToScreen ( )■%： 사용하여 창 
문단위로 표시된 마우스위 치를 화면단위로 변환하여 야 한다. LoadMenu ( )를 사용하여 
차림 표를 적재 하면 그의 첫번째 (이 실례 에서는 한개 밖에 없다.) 뭐 여 나오기차림표의 손 
잡이를 돌려 준다. 이러한 처리가 완료되면 차림표를 표시할수 있다. 

_ WIN 32_ WINNT 과는 마크로가 0 x 0500 라는 값으로 정의된 점에도 주의를 돌려 야 한 
다. 이것은 TrackPopupMenu ( ) 에서 사용되는 모든 기발들의 마크로를 포함시키기 위 
해 필요하게 된다. 


튀여나오기차림표의 동화 효과 


Windows 2000 에서는 흥미 있는 기능이 유동차림표에 추가되여 있다. 그것은 차림 
표가 표시될 때 동화효과를 제공할수 있다는것 이다. 

차림표의 동화효과란 차림표가 표시되는 순차를 설정하는것이다. 우에서부터 아래로， 
아래 에서부터 우로, 왼쪽에서부터 오른쪽으로 또는 오른쪽에서부터 왼쪽으로 순차를 설 
정할수 있다. 표 19-1 에 제시한 기발들가운데서 동화효과를 지정하는것은 아래의 다섯 
개 이 다. 

TPM_HORNEGANIMATION TPM_HORPOSANIMATION 

TPM_VERNEGANIMATION TPM_VERPOSANIMATION 

TPM_NOANIMATION 

TPM_NOANIMATION 은 동화효과를 사용하지 않고 순간적 으로 차림 표를 튀 여 나오 
기시킨다. 

아래에서부터 우로의 동화효과를 시험해 보기 위하여 앞의 실례프로그람에서 
TrackPopupMenuEx ( )를 호출하는 부분을 아래와 같이 변경해 본다. 

TrackPopupMenuEx (hsubmenu, TPM_VERNEGANIMATION , pt.x, 
pt. y, hwnd, NULL) : 

이 변경 을 진행하면 마우스의 오른쪽 단추를 찰칵하였을 때 뭐 여 나오기차림 표가 화 
면의 밑 에서 부터 웃쪽을 향해 표시되 게 된다. 차림 표의 동화효과는 튀 여나오기차림 표에 
특수한 효과를 주는 가장 간단한 방법의 하나이 다. 
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Windows 2000 으 I 새로운 기능 : 차림표의 동화효과는 Windows 2000 에 새롭게 추가된 
것 이다. 이 기능은 Windows NT 4.0 에서는 지원되지 않는다. 


WM_MENURBUTTONUP 통보문의 처 리 


이미 설명한바와 같이 최신판의 모든 Windows 에서는 마우스의 오른쪽 단추를 누 
르면 유동차림 표가 표시 된 다. 또한 도움말창문이 표시 되 는 응용프로그람도 있다. 
Windows NT 4.0 에서는 이 기능이 하나의 례외 즉 차림표를 제외 하고는 모든 사용자대 
면부의 요소에 적용되고 있다. 

Windows 2000 에서는 차림표항목에도 적용되였다. Windows 2000 에서는 차림표항 
목우에서 오른쪽 단추를 찰칵하면 WM _ MENURBUTTONUP 통히아 발생된다. 이 통보 
문을 처 리 하면 선택 된 항목에 관한 도움말정 보를 표시 하거 나 부분차림 표를 튀 여나오기 시 
킬수 있 다. WM_MENURBUTTONUP 통보문을 처 리 하는것 은 프로그람에 최 신의 조작성 
을 제공하는데 적당한 방법의 하나이다. 

WM_MENURBUTTONUP 통보문이 생성될 때는 IParam 에 차림표의 손잡이가 보관 
되며 wParam 에 오른폭 찰칵한 항목의 색인이 보관된다. 이러한 정보를 얻는 방법을 보 
여 주기 위하여 앞에서 보여 준 실례프로그람의 WindowsFunc ( ) 의 switch 문에 아래 
의 프로그람코드를 추가해 본다. 이 코드는 [ Options ] 차림표의 오른쪽찰칵을 처리하는 
코드이다. 

case WM_MENURBUTTONUP : 

// 「 Options 」 차림표의 오른쪽 찰칵을 처 려 한다 . 
if ((HMENU) IParam == GetSubMenu(GetMenu(hwnd) , 0)) 
switch (wParam) { 

case 0 ： MessageBox(hwnd, "Add Popup", 

"Right Click", MB_OK); 

break ； 

case 1 ： MessageBox(hwnd, ” Delete Popup", 

"Right Click", MB_OK); 

break ； 

case 2: MessageBox(hwnd, "Exit", 

"Right Click", MB_OK); 

} 
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break ； 

프로그람코드를 추가하고 나서 [ Op 社 ons ] 차림표를 내리펼치기하고 [Add Popup ] 을 
마우스의 오른쪽 단추로 찰칵해 본다. 그러면 통보칸이 표시되게 된다. 

프로그람코드의 처리내용을 설명해 보자. 차림표항목의 우에서 마우스의 오른쪽 단 
추를 찰칵하면 WM _ MENURBUTTONUP 통보문이 발송되며 그때 IParam 에는 차림표의 
손잡이 가 wParam 에는 차림 표항목의 색 인이 보관되 여 있다. IParam 에 보관된 값으로부 
터 [ Options ] 차림표의 손잡이를 얻을수 있으며 wParam 에 보관된 색 인으로부터 어느 
통보칸을 표시하면 좋겠는가를 판단할수 있다. 

물론 실제의 응용프로그람에서는 WM_MENURBUTTONUP 통보문에 대한 응답으 
로서 부분차림 표를 표시하거 나 도움말창문을 표시하는것 으로 될것 이 다. 통보칸은 실례를 
보여 주기 위해 표시 하였을뿐이 다. 

Windows 2000 의 새로운 기능 : Windows NT 4.0 의 프로그람을 이식 할 때는 
WM_MENURBUTTONUP 통보문을 처리하는 기능을 추가하면 좋을것이다. 


자체로 해보기 


우선 간단히 시험해 볼것이 있다. 이 장의 첫 실례프로그람에서는 [ Op 出 ons ] 차림표 
의 [ Erase ] 항목이 사용자에 의해 수동으로 추가되 거 나 삭제되 였다. 이 수법은 실례 를 
보여 주기 위한것일뿐이다. 

프로그람에서 자동적으로 [ Erase ] 항목을 추가하거나 삭제하게 할수도 있다. 실례로 
프로그람의 기동시와 같은 창문의 내용이 비여 있는 경우에는 [ Erase ] 를 무효로 해둔다. 
사용자가 창문에 어떤 그리기를 진행하였다면 [ Erase ] 항목을 유효로 한다. 사용자가 창문 
의 내용을 없애면 다시 [ Erase ] 항목을 무효로 한다. 이렇게 [ Erase ] 항목의 상태를 자동 
적 으로 설정하는것은 실제 적 인 응용프로그람의 동적차림 표에서 사용되 고 있는것 이 다. 

차림 표를 삽입 할 때 MFT_RADIOCHECK 형 식 을 설정 하고 그 효과를 확인해 본다. 

또한 차림표항목에 비트매프를 추가해 본다. 그러자면 MENUITEMINFO 구조체의 
hbmpltem 성원에 비트매프의 손잡이를 설정한다. 또한 fMask 에는 MIIM _ BITMAP 를 설 
정해야 한다. 

TrackPopupMenuEx ( ) 함수에 설정할수 있는 여 러가지 추가선택항목을 시험해 본 
다. 실례로 표시를 금지하는 령역의 정의를 진행해 본다. 또한 차림표의 배치를 달러 설 
정해 본다. 

그리고 유동차림표와 도움말체계를 통합해 본다. 어떠한 조작기능으로 하면 좋겠는가 
는 지금 많이 쓰이고 있는 응용프로그람에서 진행되는 처리를 조사해 보면 좋을것이다. 
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동적련결서고와 보안 


제 1장에서 시작한 긴 로정을 거쳐 어느덧 마지막 장에 이르렀다. 지금 
까지의 장들에서 설명한 내용을 모두 리해하였다면 Windows 2000 프로그 
탐을 작성 할수 있게 되 였 다고 말할수 있 다. 이 장에 서 설명하게 되 는 자체 
의 동적련결서 고 ( DLL ) 를 작성하는 방법 과 Windows 2000 의 보안체 계 에 
대 한 지식을 소유하면 Windows 2000 프로그람을 보다 원만하게 작성 할수 
있 다. 이 것 들을 자세 히 설명하는것 은 불가능하지 만 기 초지 식 을 알아 두는 
것은 중요하다. 

이 장에서는 매 항목에 대하여 간단히 설명하기로 한다. 




제 20 장. 동적련결서 고와 보안 


동적련결서고의 작성 


Win 32 API 서 고는 동적 련결서 고로서 제공되 고 있다. 이것은 응용프로그람에서 API 
함수를 사용하여도 그 함수의 코드는 응용프로그람의 객체파일에 포함되지 않는다는것을 
의미한다. 응용프로그람에는 API 함수의 적재명령만이 들어 있다. 실행시에 프로그람이 
적재될 때 실제의 API 함수가 련결된다. 

사용자들도 이와 갈은 방식의 자체의 동적련결서고를 작성하여 리용할수 있다. 뒤에 
서 보게 되 겠지 만 DLL 의 작성 방법 은 결코 어 렵지 않다. 우선 정 적련결과 동적련결의 
차이점에 대한 설명으로부터 시작하기로 하자. 

동적련결과 정적련결 

Windows 는 정적련결과 동적관골이라는 두 종류의 련결형식을 지원한다. 정적련결 
은 번역시에 진행된다. 정적련결되는 함수의 코드는 프로그람의 실행 ( EXE ) 파일에 물리 
적 으로 추가된다. 정 적련결되 는 함수는 .OBJ 또는 . LIB 파일안에 들어 있다. 

실례 로 대규모의 프로그람을 분할번역 하여 작성할 때는 .EXE 파일의 작성 시 에 련결 
프로그람이 개개 모둘의 .OBJ 파일을 결합한다. 이 경우에는 작성된 .EXE 파일안에 모 
든 .OBJ 파일안에 있는 코드들이 들어 있다. .LIB 파일로서 제공되는 C 八:++의 실행시 
서 고함수도 정적형 식 이며 사용자들이 작성한 프로그람에 결합된다. 

이와는 달러 동적련결은 번역 할 때 가 아니 라 프로그람의 실행시 에 진행되며 동적련 
결되는 함수의 코드가 프로그람의 .EXE 파일에 추가되지 않는다. 동적련결되는 함수는 
사용자가 작성 한 프로그람과 독립 적 으로 존재 하는 . DLL 파일안아 보관되 여 있 다. DLL 
안에 있는 함수가 프로그람의 실행시에 결합된다. 사용자가 작성한 프로그람에는 DLL 
을 적 재하기 위한 작은 코드가 련결 되 여 있지 만 함수자체 는 련결되 지 않는다. 

동적련결서고를 작성하는 리유 

어째서 자체의 동적련결서고를 작성할 필요가 제기되는가고 생각할수도 있다. 소규 
모의 프로그람에서는 그렇게 할 필요가 없다. 번역할 때 프로그람에 모든 함수를 련결하 
는 편이 간단하기때문이 다. 그러 나 기능을 몇개의 모듈에 분할하여 작성하는 대규모의 
프로그람인 경우에는 큰 가치가 있다. 그 리유는 다음과 같다. 

後 DLL 에 함수를 보관하면 매개의 모둘에 포함되는 함수가 중복되지 않게 된다. 
그러면 매 개 모둘의 크기를 작게 할수 있으며 디스크공간을 절약할수 있다. 

② DLL 을 사용하면 프로그람의 갱 신이 쉽게 된다. 정적 련결서 고의 경우는 그 안에 
보관된 함수의 기능이 변경되면 그 함수를 사용하고 있는 모든 모둘을 다시 련결하여야 
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한다. 

동적 련결서 고의 경 우는 DLL 파일만을 재 번역 하는것 으로 해 결된다. DLL 을 사용하는 
모든 응용프로그람들은 다음에 실행될 때는 새로운 판의 함수를 사용하게 된다. 

③ DLL 을 사용하면 프로그람을 부분적 으로 수정하는것 이 쉽게 된다. 실례 로 프로그 
탐에서 치 명적 인 오유가 나타난 경우는 응용프로그람전체 가 아니 라 동적련결서 고만을 수 
정하여 그것을 배포하는것 이 효률적 이 다. 

이것은 우주비행선이나 무인감시체계 등과 같은 원격환경에서 운영되는 프로그람에 
서 특히 유효하게 된다. 

물론 불러 한 점 이 없는것도 아니 다. 독자적 인 DLL 을 사용하게 되 면 프로그람은 두 
개이상의 모둘에 분할되게 된다. 이렇게 되면 프로그람의 관리가 시끄럽게 되며 어떤 문 
제 를 일으킬 가능성도 있다. 실례 로 만약 동적련결서 고와 응용프로그람사이 에 정 합이 되 
지 않으면 문제 점 이 발생할것 이 다. 그러 나 대 규모의 프로그람을 작성 하는 경 우에 는 동적 
련결서고의 우점 이 그의 부족점을 압도하게 되는것 이다. 

동적련결서고의 기초 

DLL 의 실례 프로그람을 작성 하기 에 앞서 DLL 의 작성 방법과 사용방법상의 규칙 을 
설명해 두자. 첫 번째 규칙은 DLL 에 보관되 여 있는 프로그람으로부터 호출되 는 함수는 
수출 ( Export ) 되여야 한다는것 이 다. 두번째 규칙은 DLL 에 보관된 함수를 사용하기 위 
해 서 는 그것 을 ^'( Import ) 해 야 한다는것 이 다. 

c / c++ 에 서 는 dllexport 라는 열 쇠단어 로 수출을 진행 하며 dllimport 라는 열 쇠단어 로 
수입을 진행 한다. dllexport 와 dllimport 는 Microsoft Visual C ++ 나 다른 몇 가지 번역 
프로그람에 서 지 원되 는 확장열쇠단어 이 다. 

이식과 관련한 요점 : Windows 3.1 등의 16 bit 판본의 Windows 에서는 DLL 에서 수 
출되는 함수를 .DEF 파일의 EXPORTS 구획에서 정의하여야 했다. 지금도 이 방법을 러 
용 할수 있지만 dllexport 를 사용하는 방법이 간단하다. 

dllexport 와 dllimport 의 두개 의 열 쇠 단어 는 단독으로 사용할수 없 다. _ declspec 과 
는 다른 하나의 확장열쇠단어와 함께 사용해야 한다. 아래에 일반적인 구문을 표시한다. 

— declspec ( specifier ) 

specifier 에 는 보관콜라스를 설정 한다. DLL 의 경 우는 specifier 가 dllexport 또는 
dllimport 로 된다. 실례로 MyFuncC ) 라는 함수를 수출하는 경우에는 다음과 같이 한다. 


.declspec (dllexport) void MyFunc(int a) 
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수입되거나 수출되는 함수의 선언을 간단히 하기 위해 대다수의 프로그람작성자들은 
_declspec 를 사용하는 긴 구문이 아니라 마크로를 사용한다. 실례로 다음과 같은 마크 
로이다. 


#define DllExport _ declspec (dllexport) 

이 마크로를 사용하면 아래와 같은 간단한 구문으로 MyFuncC ) 를 수출할수 있다. 


DllExport void MyFunc(int a) 


C ++ 의 프로그람으로서 번역된 DLL 을 C 언어의 프로그람에서도 사용할수 있게 하려 
는 경우에는 “ C ” 련결지정을 추가할 필요가 있다. 아래에 구문의 형식을 보여 주었다. 

#define DllExport extern “C” — declspec (dllexport) 

이렇게 하면 C ++ 독자의 이름장식이 진행되는것을 억제할수 있다. 이름장식이란 형 
정보를 추가하여 함수이 름을 내부적 으로 변경해 버리 는것 이 다. 이것은 다른 클라스의 성 
원함수나 다른 이 름공간의 함수 등으로 다중정 의된 함수를 식 별 하기 위한 대 책안이 다. 

이 책 의 실 례프로그람에 서는 이 대 책안으로 인한 문제 를 막기 위해 “ C ” 련결지 정 을 
설정한다. (C 언 어 프로그람을 번 역하는 경 우에 는 번 역프로그람에 의해 무시되 므로 
extern “ C ” 를 지정할 펼요는 없다.) 

DLL 을 번역할 때는 번역프로그람에 DLL 을 작성하기 위한 설정을 하여야 한다. 그 
를 위한 가장 간단한 방법은 새로운 프로젝트를 작성할 때 DLL 프로젝 트를 선택하는것 
이다. 번역프로그람의 추가선택을 어떻게 설정하면 좋은가를 알수 없는 경우에는 번역프 
로그람의 지도서를 참고해 야 한다. 

DLL 을 번역 하면 두 종류의 파일 이 작성된다. 하나는 함수를 보관한 DLL 본체 로서 
파일의 확장자는 .DLL 이다. 다른 하나는 함수의 적재정보를 보관한것이며 파일의 확장 
자는 .LIB 이 다. DLL 을 사용하는 프로그람에 는 이 .LIB 파일을 련결하여 야 한다. 

. DLL 과일은 그것을 사용하는 응용프로그람이 참조할수 있는 등록부에 보관하여야 한 
다. Windows 2000 은 응용프로그람이 존재하는 등록부, 현재 등록부, 표준적 인 DLL 이 
보관되 여 있는 등록부, 환경 변수 PATH 에 설정된 등록부의 순서 로 DLL 을 람색 한다. 

실험적으로 DLL 을 작성하는 경우에는 표준적 인 DLL 들이 보관되여 있는 등록부가 
아니라 응용프로그람이 존재하는 등록부에 DLL 을 보관해야 한다. 그렇게 해야 부주의 
로 체계가 사용하는 DLL 을 변경시키는것을 막을수 있다. 

프로그람이 필요한 DLL 을 찾을수 없는 경우에는 기동되지 않으며 오유를 표시하는 
통보칸이 표시된다. 
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간단한 동적련결서고의 실례 


아주 간단한 동적련결서 고를 작성 해 보자. 5 AowMouse 五 oc ， 고라는 한개의 함수만을 
가지는 DLL 프로그람 코드를 실례 20-1 에 보여 주었다. 이 함수는 단추가 눌러웠을 때 
의 마우스의 위 치를 표시하는 기능을 수행한다. 마우스의 단추가 눌러웠을 때 의 통보문 
lParam 에는 통보문이 생성되였을 때의 마우스의 위 치가 보관되여 있다는것을 이미 배웠 
다. 마우스의 위치를 표시하기 위해서는 이 값과 장치상황을 5公 ow / AfouseLoc 스乂의 파라 
메터로 전달한다. ShowMouseLocC )를 수출함수로서 선언한다는데 주의해 야 한다. 

실 례 20-1. MyDll 프로그람 

// 간단한 DLL 
♦include < windows. h> 

♦include <cstring> 


ttdefine DllExport extern "C" — declspec (dllexport) 

/* 이 함수는 마우스의 단추가 눌리웠을 때의 
마우스의 위치를 표시한다 . 

hdc: 마우스의 위치를 표시할 장치상황을 

설정 한다 . 

lParam ： 마우스의 단추가 눌러웠을 때의 lParam 의 값 
을 설정한다 . 

*/ 

DllExport void ShowMouseLoc (HDC hdc, LPARAM lParam) 

{ 

char str[80] : 

wsprintf (str, ”Bu 竹 on is down at %d, %d", 

LOWORD (lParam), HIWORD (lParam)) : 
TextOut(hdc, LOWORD (lParam), HIWORD (lParam), 
str, strlen(str)) : 


우선 이 프로그람을 MYDLL . CPP 라는 파일 이 름으로 작성 한다. 다음 DLL 프로젝 
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트를 작성한다. Visual C ++ 를 사용하는 경 우에 는 [ New ] 대 화칸의 [ Project ] 표쪽에 서 
[ Win 32 Dynamic Link Ubrary ] 를 선택 한다. 프로젝 트에 MYDLL.CPP 를 추가하고 서 
고를 번역하면 MYDLL.DLL 및 MYDLL.LIB 라는 두개의 파일 이 생성된다. 

이미 설명한것처럼 . DLL 파일은 동적련결서고의 본체이다. . LIB 파일은 이 동적련결 
서 고를 사용하는 응용프로그람에 련결해 야 하는 적재정 보를 보관한 파일 이다. 

머리부과일의 작성 

프로그람에서 표준적 인 서 고함수를 사용할 때와 같이 DLL 에 보관된 함수를 사용하 
는 경우에도 함수의 선언을 하여 야 한다. DLL 에 보관된 함수의 선언을 하는 간단한 방 
법은 DLL 용의 머리부파일을 작성해 두는것이다. 실례로 MYDLL.DLL 을 위한 머리부 
파일 이라면 아래 와 같이 한다. 이것 을 MYDLL.H 라는 파일 이 름으로 작성 한다. 

♦define Dlllmport extern "C" _declspec (dllimport) 

Dlllmport void ShowMouseLoc (HDC hdc, LPARAM IParm) : 


동적련결서고의 사용법 

DLL 을 번역하여 그것을 적절한 등록부에 보관하고 DLL 용의 머리부파일을 작성하 
면 DLL 을 사용할 준비는 끝났다. MYDLL . DLL 을 사용하는 간단한 프로그람을 아래에 
보여 주었다. 이 프로그람은 마우스의 왼쪽 단추 혹은 오른쪽 단추가 눌리웠을 때의 마 
우스의 위 치를 표시하는 프로그람이다. 프로그람의 실행결과를 그림 20-1 에 준다. 이 
프로그람을 번역할 때는 련결목록에 MYDLL.LIB 를 반드시 설정해야 한다. 프로그람을 
실행 하면 MYDLL.DLL 로부터 ShowMouseLoc ( ) y \ 자동적 으로 적재된다. 


// DLL 에 보관된 ShowMouseLoc ( ) 의 사용 

ttinclude < windows. h> 

#include <cstring> 

♦include "mydll. h" 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) : 
char szWinName[] = "MyWin”; // 창문를라스의 이름 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 


교육성 프로그람교육멘터 


775 



Windows 2000 프로그람작성 법 


{ 

HWND hwnd ； 

MSG msg ； 

WNDCLASSEX wcl ； 

// 창문물라스를 정의 한다 . 

wcl. cbSize = sizeof (WNDCLASSEX) ; 

wcl.hlnstance = hThisInst ； // 실체의 손잡이 
wcl. IpszClassName = szWinName ； // 창문믈라스의 이름 
wcl. lpfnWndProc = WindowFunc ； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이콘 
wcl.hlconSm = NULL ； // 큰 아이콘의 축소판을 사용한다 . 
wcl.hCursor = LoadCursor(NULL, IDC_ARROW) ; // 유표의 형 식 

wcl.IpszMenuName = NULL ； // 를라스차림표는 없다 . 
wcl.cbClsExtra = 0 ； // 보조기억기령역은 필요 없다 . 

wcl. cbWndExtra = 0 ； 

// 창문의 배경색을 흰색으로 한다 . 

wcl. hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 


// 창문물라스를 등록한다 . 

if( ! RegisterClassEx(&wcl)) return 0 ； 


A 창문물라스가 등록되 였으므로 
창문을 작성할수 있다 . */ 
hwnd = CreateWindow( 
szWinName, // 창문믈라스의 이름 
"Demonstrate a DLL", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다 . 
CWJJSEDEFAULT, // X 자리 표는 Windows 가 결정 하게 한다 . 
CW_USEDEFAULT, // Y 자리 표는 Windows 가 결정 하게 한다 . 
CWJJSEDEFAULT, // 너비는 Windows 가 결정하게 한다 . 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다 . 
NULL, // 어미창문은 없다 . 
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NULL, // 차림표는 없다 . 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다 . 

)； 


// 창문을 표시한다 . 

ShowWindow (hwnd, nWinMode); 

UpdateWindow (hwnd) ； 

// 통보문순환고리률 작성 한다 . 

while(GetMessage (&msg, NULL, 0, 0)) 

{ 

TranslateMessageUmsg); // 건반통보률 변환한다 . 
DispatchMessage(&msg) ； // Windows 2000 에 조종을 넘 긴다 . 

} 

return msg. wParam ； 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다 . 

*/ 

LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc ； 


switch (message) { 

case WM_RBUTTONDOWN : // 오른쪽 단추를 처 리 한다 . 
hdc = GetDC(hwnd) ； // 장치 상황을 엄는다 . 

ShowMouseLoc(hdc, IParam) ； // DLL 에 보관된 함수률 호출한다 . 

ReleaseDC(hwnd, hdc) ； // 장치 상황을 해 제 한다 . 

break ； 

case WM.LBUTTONDOWN : // 왼쪽 단추를 처 리 한다 . 
hdc = GetDC(hwnd) ； // 장치 상황을 얻 는다 . 

ShowMouseLoc (hdc, IParam); // DLL 에 보관된 함수를 처리 한다 . 

ReleaseDC (hwnd, hdc); // 장치 상황을 해제 한다 . 

break ； 
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case WM.DESTROY ： // 프로그람을 끝낸다 . 

PostQuitMessage (0) ； 
break ； 
default ： 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다 . */ 
return DefWindowProc(hwnd, message, wParam, IParam) ； 

} 

return 0 ； 

} 



그림 20-1. 첫 Dl 丄프로그람의 실행결과 


DIIMaint 》의 사용방법 


DLL 에는 어떤 초기화처리나 완료처리가 필요한것들도 있다. 이러한 처리를 실현하 
기 위 하여 DLL 이 초기 화되 거 나 완료될 때 호출되 는 DUMain () 과는 이 름의 함수를 
DLL 안에 작성 한다. 이 함수는 DLL 의 원천파일 안에 써 넣 는다. 

그러나 이 함수를 작성하지 않는 다고 해도 번역프로그람에 의해 암시적처리를 진행 
하는 코드가 DLL 에 추가된 다. 그러 므로 앞절 에 서 작성 한 DLL 에 서 DUMain ( ) 을 서 술 
하지 않아도 문제가 생기지 않았던것이다. 물론 아무리 소규모인 DLL 이라고 해도 모두 
내부에 DllMain ( ) 을 가지고 있다. 아래에 선언을 보여 주었다. 


BOOL WINAPI DllMain (HANDLE hlnstance , DWORD What , 
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LPVOID NotUsed ) ; 


Windows 2000 이 DllMain ( ) 을 호출했을 때 hlnstance 에는 DLL 실체 의 손잡이 가 
설정되며 What 에 는 발생한 사건의 내 용이 설정된다. NotUsed 는 이미 예 약된것 이 다. 
What 는 다음의 몇가지 값으로 된다. 


DLL PROCESS ATTACH 

프로세 스가 DLL 의 사용을 개 시했 다. 

DLL PROCESS DETACH 

프로세 스가 DLL 을 해 제하였 다. 

DLL THREAD ATTACH 

프로세 스가 새 로운 스레 드를 작성했 다. 

DLL _ THREAD_DETACH 

프로세 스가 스레 드를 파괴했 다. 


What 의 값이 DLL_PROCESS_ATTACH °쇼 경 우에 는 프로세 스가 DLL 을 적 재 하였 
다는것을 의미한다. 정확히는 DLL 이 프로세스의 주소공간에 넘기기 ( Mapping ) 되였다는 
것 이 다. 이 사건에 대 한 응답으로서 DllMain ( ) 이 령 을 돌려 주면 프로세 스는 DLL 의 
배 속 을 중 지 한 다 . DLL 을 사 용 하 는 여 러 개 의 프 로 세 스 가 있 어 도 
DLL _ PROCESS_ATTACH 를 파라메 터 로 하여 DllMainC ) 이 호출되 는것 은 한번만이 다. 

What 의 값이 DLL_PROCESS_DETACH 안 경 우는 프로세 스가 DLL 을 필 요로 하지 
않게 되 였다는것 을 의 미한다. 이것은 프로세 스자체 가 완료될 때 발생하는 사건이 다. 이 
사건은 DLL 이 해제될 때 도 발생한다. 

이 미 DLL 에 배 속 되 여 있 는 프 로 세 스 가 새 로 운 스 레 드 를 작 성 하 면 
DLL_THREAD_ATTACH 를 파라메 터 로 하여 DllMainC ) 이 호출된 다. 스레 드가 파괴 되 
면 DLL_THREAD_DETACH 를 파라메터 로 하여 DllMain () 이 호출된다. 여 러 개의 스레 
드의 배속 및 분리 통보 문이 한 프로세스에서 발생되는 경우도 있 다. 
DLL _ PROCESS _ ATTACH 통보문을 처리할 때를 제외하고는 DllMain ( ) 의 돌림값은 무 
시된 다. 

일반적인 선«시에서는 그것이 호출되였을 때의 What 의 값에 따라 결정되는 처 

리를 진행한다. 결정된 처리라는것은 령이 아닌 값을 돌려 주는것뿐이다. 


이식과 관련한 요점 : Winl6 용의 DLL 에서는 DUMain( ) 대신에 LibMainC ) 이 사용된 
다. 낡은 프로그람을 이식하는 경우에는 변경이 필요하다. 


MYDLL 에 DIIMain ( ) 을 추가 

DllMainC ) 이 호출되는 시점을 확인하기 위해 아래 에 보여 주는 DllMainC ) 을 
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MYDLL.CPP 에 추가해 보자. 

// 간단한 DLL 
#include < windows. h> 
ttinclude <cstring> 


#define DllExport extern "C" _declspec (dllexport) 


A 이 함수는 초기화 및 완료시에 
호출된다. 히 

BOOL WINAPI DllMain(HANDLE hlnstance, DWORD what, 
LPVOID Notused) 

{ 

switch (what) { 

case DLL_PROCESS_ATTACH : 

MessageBox(HWND.DESKTOP, ” Process attaching DLL.，，, 
"DLL Action", MB_OK) ； 

break； 

case DLL_PROCESS_DETACH : 

MessageBox(HWND_DESKTOP, ” Process detaching DLL.", 
"DLL Action”, MB_OK) ； 

break； 

case DLL.THREAD_ATTACH : 

MessageBox(HWND.DESKTOP, ” Thread attaching DLL.’，, 
"DLL Action", MB_OK) ； 

break； 

case DLL_THREAD.DETACH : 

MessageBox(HWND.DESKTOP, ” Thread detaching DLL.，，, 
"DLL Action", MB_OK) ； 

break； 

} 

return 1； 

} 

A 이 함수는 마우스의 단추가 눌러웠을 때의 
마우스의 위치를 표시한다. 

hdc： 마우스의 위치를 표시할 장치상황을 
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설정 한다. 

IParam： 마우스의 단추가 눌러워 졌을 때의 IParam 의 값을 
설정 한다. 

비 

DllExport void ShowMouseLoc (HDC hdc, LPARAM IParam) 

{ 

char str[80] : 

wsprintf (str, "Button is down at %d, %d", 

LOWORD (IParam) , HIWORD (IParam )); 

TextOut (hdc, LOWORD (IParam), HIWORD (IParam), 
str, strlen(str)) ； 

} 

DllMain () 이 호출될 때 마다 그때 의 사건내 용이 통보칸에 표시 된다. MessageBox () 
의 첫 파 라 메 터 에 HWND—DESKTOP 를 설 정 하 는 것 을 주 의 해 야 한 다 . 
HWND_DESKTOP 는 화면을 가리키는것 이므로 통보칸을 응용프로그람과 독립시켜 표 
시할수 있다. 

또 하나 보충적으로 알아 두어야 할것은 DllMainC ) 은 응용프로그람으로부터 호출되 
는것이 아니므로 MYDLL.DLL 로부터 수출되지 않는다. Windows 만이 DllMain ( ) 을 
호출한다. 

DllMainC ) 의 실례 

실례 20-2 의 프로그람은 DllMainC ) 의 실례 이 다. 앞에서 본 프로그람과 마찬가지 로 
마우스의 왼쪽 단추 또는 오른쪽 단추가 눌리웠을 때 마우스의 위 치를 표시하는 
ShowMouseLoc ( ) 함수를 호출한다. 그러나 임의의 건을 누르면 스레드가 하나 작성되 
는 기능이 추가되여 있다. 

이 프로그람을 실행하면 DllMainC ) 이 호출되는가를 확인해 본다. 프로그람의 실행 
결과를 그림 20-2 에 보여 주었다. 프로그람에 MYDLL.LIB 를 련결하는것을 잊지 말아 
야 한다. 

실례 20-2. DllMain 프로그람 


//DLL 초기화의 실례 

ttinclude〈windows. h> 
ttinclude <cstring> 
#include <cstdio> 
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♦include "mydll. h" 

#define MAX 10000 

LRESULT CALLBACK WindowFunc(HWND, UINT, WPARAM, LPARAM) : 
DWORD WINAPI MyThreadCLPVOID param) : 
char szWinName[] = "MyWin" : // 창문들라스의 이름 
char str[255] = ""； // 표시할 문자렬을 보관한다. 

DWORD Tidl； // 스레 드 ID 


int WINAPI WinMain(HINSTANCE hThisInst, HINSTANCE hPrevInst, 
LPSTR IpszArgs, int nWinMode) 

{ 

HWND hwnd； 

MSG msg； 

WNDCLASSEX wcl； 

// 창문물라스를 정의 한다. 

wcl. cbSize = sizeof (WNDCLASSEX) : 


wcl.Mnstance = hThisInst； // 실체의 손잡이 
wcl. IpszClassName = szWinName； // 창문클라스의 이름 
wcl. lpfnWndProc = WindowFunc； // 창문함수 
wcl.style = 0; // 체계설정의 형식 

wcl.hlcon = LoadIcon(NULL, IDI_APPLICATION); // 큰 아이 콘 

wcl. hlconSm = NULL； // 큰 아이론의 축소판을 사용한다. 

wcl. hCursor = LoadCursor(NULL, IDC_ARROW) : // 유표의 형 식 

wcl. IpszMenuName = NULL； // 믈라스차림표는 없다. 
wcl.cbClsExtra = 0; // 보조기억기령역은 필요 없다. 

wcl. cbWndExtra = 0； 

// 창문의 배경색을 흰색으로 한다. 
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wcl.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH) ; 

// 창문물라스를 등록한다. 

if( ! RegisterClassEx(&wcl)) return 0； 


/* 창문물라스가 등록되 였으므로 
창문을 작성할수 있다. */ 
hwnd = CreateWindow ( 
szWinName, // 창문들라스의 이름 
"Using DllMain", // 제목 

WS_OVERLAPPEDWINDOW, // 창문의 형식은 표준으로 한다. 
CWJJSEDEFAULT, // X 자러 표는 Windows 가 결정 하게 한다. 
CWJJSEDEFAULT, // Y 자리 표는 Windows 가 결 정 하게 한다. 
CW_USEDEFAULT, // 너 비는 Windows 가 결정 하게 한다. 
CWJJSEDEFAULT, // 높이는 Windows 가 결정 하게 한다. 
NULL, // 어미창문은 없다. 

NULL, // 차림표는 없다. 

hThisInst, // 실체의 손잡이 
NULL // 추가파라메 터 는 없 다. 

)； 


// 창문을 표시 한다. 

ShowWindow (hwnd, nWinMode) : 

UpdateWindow (hwnd) : 

// 통보문순환고리를 작성 한다. 

while (GetMessage (&msg, NULL, 0, 0)) 

{ 

TranslateMessage(&msg) : // 건반통보를 변환한다. 

DispatchMessage(Smsg) ; // Windows 2000 에 조종을 넘 긴다. 

} 

return msg.wParam; 

} 

/* 이 함수는 Windows 2000 으로부터 호출되 여 
통보문대기렬에서 꺼낸 통보문을 받아 들인다. 

*/ 
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LRESULT CALLBACK WindowFunc (HWND hwnd, UINT message, 
WPARAM wParam, LPARAM IParam) 

{ 

HDC hdc； 

PAINTSTRUCT ps； 

switch (message) { 

case WM.RBUTTONDOWN : // 오른쪽 단추를 처 리 한다. 
hdc = GetDC(hwnd) ； // 장치 상황을 얻 는다. 

ShowMouseLoc(hdc, IParam) ； // DLL 에 보관된 함수률 처 리 한다. 

ReleaseDC(hwnd, hdc) ； // 장치 상황을 해 제 한다. 

break； 

case WM.LBUTTONDOWN : // 왼쪽 단추를 처 리 한다. 
hdc = GetDC(hwnd) ； // 장치 상황을 얻 는다. 

ShowMouseLoc (hdc, IParam); // DLL 에 보관된 함수를 호출한다. 

ReleaseDC(hwnd, hdc); // 장치상황을 해제한다. 

break； 

case WM.CHAR： // 건이 눌러웠다면 스레드를 기동한다. 
CreateThread (NULL, 0, 

(LPTHREAD_START_ROUTINE) MyThread, 
(LPVOID) hwnd, 0, &Tidl) ； 

break； 

case WM_PAINT: 
hdc = BeginPaint (hwnd, &ps) ； 
strcpy(str, ” Press a key to start a thread."); 

TextOut(hdc, 1, 1, str, strlen(str)) ； 

EndPaint(hwnd, &ps) ； 
break； 

case WM.DESTROY： // 프로그람을 끝낸다. 

PostQuitMessage (0); 
break； 
default : 

/* 이 switch 문에서 지정된것 이외의 통보문은 
Windows 2000 에 처 리를 맡긴다. */ 
return DefWindowProc(hwnd, message, wParam, IParam); 

} 
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// 또하나의 스레드 

DWORD WINAPI MyThreadCLPVOID param) 

{ 

int 1 ； 

HDC hdc； 

for(i=0； i<MAX； i++) { 
sprintf (str, "In thread： loop # %5d ", i); 
hdc = GetDC((HWND) param); 
TextOut(hdc, 1, 20, str, strlen(str)) ； 
ReleaseDC((HWND) param, hdc)； 

} 

return 0； 

} 



.au 20-2. DIIMainl _ _l' 

프로그람이 기동할 때에 [Process attaching DLL ] 라는 통보칸이 표시된다. 임의의 
건을 누르면 새 로운 스레드가 기동되고 [Thread Attaching DLL ] 라는 통보칸이 표시된 
다. 스레 드가 완료되면 [Thread Detaching DLL ] 라는 통보칸이 표시된다. DllMain ( ) 
이 언제 무엇때문에 호출되는가를 알아 보기 위해 이 프로그람에서 이것저것 시험해 본 
다. 독자적 인 DLL 이 지금 당장은 필요되지 않을지도 모르지 만 사실 여 러 가지 상황에서 
쓸모가 있다. 
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I 다시 한보 전진| 


실행시동적련결 (Run-time Dynamic Link) 

dll 에 보관된 함수를 사용할 때는 원천코드안에서 함수이름을 지정하여 호 
출하는것이 일반적이다. 이것은 이 책의 실례프로그람에서 API 를 호출할 때나 
ShowMouseLoc ( )를 호출할 때 쓰이는 수법 이 다. 이 경우에는 함수를 보관한 
DLL 이 응용프로그람과 함께 적재된다. 이것은 적재시동적 련결 ( Load-time 
Dynamic Link ) 이라고 한다. 그러나 실행시에 DLL 을 적재하는것도 가능하다. 

DLL 에 보관된 함수를 명시적으로 호출하지 않은 경우는 프로그람의 실행시 
에 DLL 이 적재되는것 이 아니 다. 필요에 따라 DLL 에 보관된 함수를 호출할수도 
있 다. 그러 자면 프로그람에 서 DLL 을 적재 하고 나서 호출하려 는 함수의 지 시 자를 
얻는다. 이것을 실행시동적 련결 이라고 한다. 실행시동적련결을 하기 위 해서는 아 
래의 세개 함수를 리용한다. 

HMODULE LoadLibrary (LPCSTR DllName ) ; 

BOOL FreeLibrary (HMODULE hMod ); 

FARPROC GetProcAddress (HMODULE hMod , LPCSTR FuncName ) : 

LoadLibrary ( ) 는 DllName 에서 지정된 DLL 을 적재하고 그의 손잡이를 돌 
려 준다. FreeLibrary () 는 불필요하게 된 DLL 을 해제 한다. GetProcAddress ( ) 
는 hMod 에서 지정된 DLL 에 보관된 함수의 이름을 FuncName 에서 지정하면 
그 함수의 지시 자를 돌려 준다. 이 지시자를 사용하여 목적하는 함수를 호출할수 
있다. 그러 나 주의해 야 한다. 지 정하는 함수는 DLL 에 있는 함수의 이 름과 일치 
해 야 한다. C ++ 의 이 름장식 에 의하여 함수이 름이 변경되는 경우도 있다. 이것 을 
방지하기 위해 “ C ” 련결지정을 사용할수 있다. 

실행시동적련결을 시험해 보기 위해서 DLL 의 두번째 실례프로그람에서 아래 
와 같은 변경을 해 보자. 우선 대역손잡이를 추가한다. 

HMODULE hLib； 

다음에 WinMainC ) 의 통보문순환고리 밑에 다음의 프로그람코드를 삽입한다. 

hlib = LoadLibrary (“MYDLL. DLL”); 

if (Ihlib) MessageBox(hwnd, “Cannot Load Library”, 

“Error”, MB_OK); 

다음 WindowFuncC ) 안에 함수의 지시 자를 추가한다. 

void (*f) (HDC, LPARAM); 
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마지막으로 마우스통보문의 처리를 다음과 같이 변경한다. 

case WM.RBUTTONDOWN : // 오른쪽 단추를 처 리 

hdc = GetDC(hwnd) ； // 장치 상황을 얻 는다. 

// ShowMouseLoc( ) 의 지시 자률 얻는다. 

f = (void (*) (HDC, LPARAM)) GetProcAddress (hlib, 

ShowMouseLoc”); 

// ShowMouseLoc( ) 률 호출한다. 

(*f) (hdc, IParam) ； 

ReleaseDC(hwnd, hdc); // 장치상황을 해제한다. 
break； 

case WM.LBUTTONDOWN : // 왼쪽 단추를 처 리 한다. 

hdc = GetDC(hwnd) ； // 장치 상황을 얻 는다. 

// ShowMouseLoc( ) 의 지시자를 얻는다. 

f = (void (*)(HDC, LPARAM)) GetProcAddress(hlib, “ShowMouseLoc”); 

// ShowMouseLoc( )를 호출한다. 

(*f)(hdc, lparam); 

ReleaseDC(hwnd, hdc) ； // 장치 상황을 얻 는다. 
break； 

竹 7 통보문을 처 리 하는 부분에 FreeLibrary ( )를 호출하는 프로 
그람코드를 추가한다. 이렇게 변경한 프로그람은 DLL 을 동적으로 적재하고 
ShowMouseLoc ( )를 직접적으로가 아니라 지시자를 통해서 호출한다. 

보통은 적재시동적 련결을 사용해 도 무방하지 만 실행시동적 련결에는 확장기능 
이 있다. 실례로 현재의 콤퓨터에 목적하는 DLL 이 존재한다면 그 DLL 의 기능 
을 사용하고 존재하지 않는다면 다른 수단을 사용할수 있다. 


보안기능 


제 1 장에서 설명 한것 처 럼 Windows 2000 에 는 C 2 보안준위 에 해 당하는 보안기능이 갖 
추어 져 있다. Windows 2000의 보안부분체계에서는 몇가지 보안기능을 제공하고 있다. 
그가운데서 기본적인 두가지 기능으로서 콤퓨터본체 및 여러가지 객체에 대한 호출조종 
이 있다. 전자는 Windows 2000 에로의 등록을 통제하는것 이며 후자는 호출권을 통제 하 
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는것 이 다. 

보안설정 을 진행하는 객체의 종류에는 파일 (NTFS 만 가능), 파이프，프로세 스, 스 
레드，체계자료기지열쇠，인쇄기,탁상면 및 동기화객체(신호기 등)가 있다. 이 기능들밖 
에도 Windows 2000의 보안체계는 보안사건의 감시, 기억기의 보호 및 조작체계의 보호 
(변경 방지) 등의 기능도 제공하고 있다. 

보안기능은 Win 32 API 서고에 편입되여 있다. 보안기능은 얇은 층과 같은것으로서 
응용프로그람에 큰 부담을 주지 않는다. 보안기능을 특별히 필요로 하지 않는 응용프로 
그람에는 영 향을 미치지 않는다. 

실례 로 지금까지 거슬러 온 장들에서 사용해 온 API 함수들가운데 는 파라메터 에 보 
안서 술자를 설정 할수 있는 함수들이 있었다. 그때 는 파라메터 에 NULL 을 설정했으며 
그렇게 함으로써 체계설정 의 보안서 술자가 리 용되게 되 였던것 이 다. 

실천적인 문제로서 많은 Windows 프로그람작성자들에게 있어서 보안기능을 엄밀히 
설정할 필요는 없을것이다. 그러나 기본적인 틀거리만은 알아 두어야 할 필요가 있다. 

용어의 정의 

보안기능을 습득하기 위한 첫 걸음은 몇가지 용어의 의미를 리해하는것이다. 보안서 
술자는 무엇이 객체를 호출하고 어떻게 객체를 호출할수 있는가를 결정하는것이다. 이것 
은 SECURITY — DESCRIPTOR 구조錢 에 의 해 지 적된다. 

프로그람에서 이 구조체를 직접 조작하는것은 아니 다. 대신 여러가지 API 함수들을 
사용하여 구조체의 설정내 용을 엄거 나 설정 을 진행 한다. 

보안서술자는 소유자나 그의 단체와 관련한 정보를 포함하고 있다. 임의접근조종목 
록 또는 체계접근조종목록도 포함되여 있다. 

소유자와 단체는 보望/ T /( SID ) 에서 지적된다. SID 는 여러가지 보안정보를 가지 
는 유일한 값이 다. 

접근조종목록 ( J 노 CV ) 은 객체를 호출하고 있는 사용자를 관리하는 목록이다. ACL 은 
접근조종입구 〈Access Control Entry ) 로 구성된다. ACE 는 객체에 대한 사용자 또는 단 
체의 호출권을 설정하는것 이 다. ACL 은 호출등록을 감시하는데 사용된다. 

ACL 에는 임의접근조종목록 ( DACL ) 과 체계접근조종목록(之 AC 노)악 두 종류가 있다. 
DACL 은 객체 를 호출하고 있는 사용자 혹은 호출의 종류를 설정하는것 이 다. 그러 므로 
객 체의 DACL 이 객체 에 대 한 사용자나 단체의 호출권을 결정하는것 으로 된다. 

객체에 DACL 이 없는 경우는 모든 사용자에게 모든 호출권이 부여된다. 객체의 소 
유자는 DACL 의 내용을 변경시킬수 있다. 

SACL 은 호출사건의 등록을 감시하는것 이 다. 체계관리자 (System Administrator ) 권 
한을 가진 사용자는 SACL 의 내 용을 변경 시킬수 있다. 

정근 g 표 (Access token ) 는 사용자를 식별하고 사용자의 보안속성을 가리키는것 이 다. 
그가운데는 사용자의 SID , 호출권 및 체계설정의 DACL 이 포함되 여 있다. 

프로세스 에는 호출권의 모임이 정의되여 있다. 호출권은 64 bit 옹근수값의 幻 로 
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표시 된 다. LUID 는 Locally Unique Idea 任 fier 꺅 략칭 이 다. 호출권의 실례 로서 는 체 계 시 
간의 설정이나 체계의 정지 (shut down ) 를 진행하는 권리 등이 있다. 경우에 따라서는 
호출에 특수한 과제를 실행시키기 위한 호출권을 변경하는것도 있다. 

보안구조 

Windows 2000의 보안부분체계가 객체에 대한 호출을 통제하는 기본적인 구조를 설 
명해 보자. 보안설정이 가능한 객체는 객체의 소유자 및 객체의 작성자를 정의하는 보안 
서술자와 관련 이 지어 진다. 

사용자가 등록하면 사용자를 식별하기 위한 접근통표가 주어 진다. 이것은 사용자가 
소속된 단체를 정의하는것이기도 하다. 사용자에 의해 기동된 프로그람은 접근통표의 복 
사본을 가전다. 그러므로 사용자가 객체를 호출하기 위해서는 객체의 호출을 허가 받아 
야 하는것이 아니라 호출의 종류에 따르는 호출권을 얻어야 한다. 이것이 사용자와 사용 
자가 가지는 호출권이 프로세스에 련결되는 구조이다. 

프로세스가 객체를 호출하려고 하면 사용자의 접근통표가 객체의 DACL 과 비교된 
다. 목록안의 ACE 가 접 근통표와 일 치하면 호출이 허 가된 다. 그렇 지 않은 경 우는 호출 
이 거부된다. 

등록가입 ( logon ) 의 호출은 그자체 가 보인호/方/관 ZM 7( SAM_Security Account 
Manager ) 에 의해 관리된다. 등록가입 에는 사용자명과 통과암호의 입력 이 필요하. 이 
통과암호는 체계전체에 대한 기본적 인 보안기능을 제공하는것으로 되여 있다. 

보안과 관련된 API 

Windows 2000 에는 보안기능을 조작하는 API 함수들이 대 단히 많다. 다음에 그중 
주되는 함수들만을 보여 주었다. 




AdjustTokenPrivileges ( ) 

이미 있던 호출권을 유효 혹은 무효로 한다. 

Get Ace ( ) 

ACE 의 지시자를 엄는다. 

GetFileSecurity ( ) 

파일의 보안설정을 엄는다. 

GetSecurityDescriptorDacl ( ) 

보안서술자의 DACL 의 지시자를 얻는다. 

GetSecurityDescriptorSacl ( ) 

보안서술자의 SACL 의 지시자를 얻는다. 

GetSecuritylnfo ( ) 

객체의 손잡이를 주고 보안서술자의 복사 
를 엄는다. 

InitializeSecurityDescriptor ( ) 

보안서술자를 초기화한다. 

LogonUser ( ) 

등록가입 을 진행한다. 

SetFileSecurity ( ) 

파일의 보안을 설정한다. 

SetSecurityDescriptorDacl ( ) 

보안서술자에 DACL 을 추가한다. 

SetSecurityDescriptorSacl ( ) 

보안서 술자에 SACL 을 추가한다. 
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or 책을 끝내며 


Windows 2000 은 지금까지 개 발된 쏘프트웨 어체 계 들중에서 가장 거대 하고 복잡한 
체계의 하나이다. Windows 2000 의 모든 내용을 다 설명할수는 없다. 이 책에서는 망, 
자료압축，동화상 등의 항목은 취급할수 없었다. 

이외에도 례 하면 COM (Component Object Model ) 과 같이 Windows 프로그람작성 
자가 알아두어 야 할 항목이 대 단히 많다. Web 의 개 발도 Windows 의 환경 을 확장하는 
요인으로 되고 있다. 그러나 걱정할 필요는 없다. 장래에 Windows 2000 프로그람작성 
기술이 어떻게 확장된다고 해도 이 책을 읽어주신 여러분들에게는 새로운 기술에 추종할 
만한 확고한 기초지식이 준비되여 있기때문이다. 
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GetScrollInfo() 함수 .153 

GetStockObjectO 함수 .208, 239 

GetSubMenu() 함수 .734 

GetSystemMetrics().208 

GetSystemMetrics() 함수 .208 

GetSystemTimeC) 함수 .585 

GetTextExtentPoint32() 함수 .231 

GetTextMetrics () 함수 .229 

GetThreadPriority() 함수 .552 

GM_ADVANCE 마크로 .300 

GM_COMPATIBLE 마크로 .300 

GROUPBOX 명령문 .188 

GROUPBOX 조종체 .188 

H 

HANDLE 자료형 .20 

HDC 형 .51 

HDITEM.490 

HDITEM 구조체 .488, 495 

HDLAYOUT 구조체 .489, 492 
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HDM_LAYOUT 통보문 . 492 

HDN_BEGINTRACK 통보문 .... 496, 509 

HDN_ENDTRACK 통보문 . 

. 496, 508, 509, 522 

HDN_ITEMCLICK 통보문 . 496, 509 

HDN_ITEMDBLCLICK 통보문 509, 522 

HDN_TRACK 통보문 . 509 

HDS_BUTTONS 형 식 마크로 . 

. 487, 509, 520 

Header_GetItem() 통보문마크로 . 522 

Header_SetItem() 통보문마크로 . 522 

HELP_CONTEXTMENU. 614, 617 

HelP_PARTIALKEY 마크로 . 642 

HELP_WM_HELP 마크로 . 614 

HELPINFO 구조체 . 615 

HH_TP_CONTEXTMENU. 633 

HH_TP_HELP_CONTEXTMENU.... 633 
HH_TP_HELP_WM_HELP. 633 


HIWORD.40 


n 丄 vv 、人[、丄» . 

HIWORDO 마크로 . 

.68. 69 

HKEY CURRENT USER..... 

… 710, 

711 

HKEY_LOCAL_MACHINE... 

...710, 

728 

HKEY PERFORMANCE DATA...... 

728 

hPrevInst. 


..24 

hThisInst. 


..24 

HTML Help Workshop. 


630 

HtmlHelp() 함수 . 

...631， 

633 

HTML 도움말 . 

...596, 

629 

HWND_DESKTOP 마크로 ..... 

"… 29, 

781 

HWND 자료형 . 


..20 

ICON 명 령 문 . 


219 

IDCANCEL 마크로 . 

…" 38, 

118 

IDD LB1. 


124 

IDD.SELECT. 


124 

IDOK 마크로 . 


..38 


I 

InitCommonControlsEx() 함수 .324 

INITCOMMONCONTROLSEX 구조체 

.324 

■ 파일 .709 

InsertMenuItem() 함수 .730 

InvalidateRect() 함수 .62, 66 

IsDialogMessage() 함수 .139 

K 

KEY_QUERY_VALUE 마크로 .715 


KEY_SET_VALUE 마크로 .715 

KillTimerO 함수 .177 


L 

LARGE_INTEGER 공용체 .584 

LB_ADDSTRING 통보 문 .125 

LB_ERR 통보 문 . 125 

LB_FINDSTRING 통보 문 . 126 

LB_GETCURSEL 통보 문 . 125 

LB_GETTEXT 통보 문 . 126 

LB_SELECTSTRING 통보 문 . 125 

LB_SETCURSEL 통보 문 . 126 

LBN_DBLCLK 통보 문 . 124 

LIB 국■일 . 771 

LineToO 함수 . 276 

LISTBOX 명 령 문 . 123 

LoadAccelerators() 함수 . 94 

LoadBitmap() 함수 . 194 

LoadCursorO 함수 . 27, 221, 224 

LoadlconO 함수 . 26, 221, 224 

LoadlmageO 함수 . 27, 221, 224 

LoadMenu() 함수 . 102 

LoadString() 함수 . 704 

LOGFONT 구조체 . 256 

LOGPIXELSX 마크로 . 664 

LOGPIXELSY 마크로 . 664 

LONG 자료형 . 21 

LOWORD. 40 

LOWOREK) 마크로 . 68, 69 

IParam. 39 

LPARAM 자료형 . 39 

LPCSTR 자료형 . 21 

lpDFunc(). 139 

LPINITCOMMONCONTROLSEX... 324 

LPSTR 자료형 . 21 

IpszArgs. 24 

IpszMenuName. 85 

LR_DEFAULTSIZE 마크로 . 225 

LR_LOADFROMFILE 마크로 . 225 

LRESULT CALLBACK.19 

lstrlen().549 

LTEXT 조종체 .188 

LUID(Locally Unique Identifier).789 

M 

MAKELONGO 마크로 .379 
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MapDialogRect() 함수 . 485 

MB_OK. 187 

MCM_GETMINREQRECT 통보문.... 526 

MENUITEMINFO 구조체 . 730 

MENUITEM 명 령문 . 82 

MENU 명 령문 . 81 

MessageBeep() 함수 . 187 

MessageBox() 함수 . 37 

MF—BYCOMMAND 마크로 . 734, 735 

MF_BYPOSITION 마크로 . 734, 735 

MFC (Microsoft Foundation Classes).. 15 

MIIM_BITMAP.733, 769 

MIIM_STRING.733 

MIIM_SUBMENU.752 

MK_CONTROL 마크로 .72 

MK_LBUTTON 마크로 .72 

MK—MBUTTON 마크로 .73 

MK_RBUTTON 마크로 .72 

MK_SHIFT 마크로 .72 

MK_XBUTT0N1 마크로 .73 

MK_XBUTTON2 마크로 .73 

MM_ANISOTROPIC 마크로 .315 

MMJSOTROPIC 마크로 .315 

MM_TEXT 마크로 .315 

MONTH CALJXASS.523 

MoveToEx() 함수 .276 

MoveWindow() 함수 .493, 494 

msg.25 

MSG 구조체 .30 

N 

NEWTEXTMETRICEX 구조체 .230 

NMHDR 구조체 . 331, 402, 425, 445 

NMHEADER 구조체 .496 

NMTTDISPINFO 구조체 .330 

NOINVERT 마크로 .92 

NORMAL_PRIORITY_CLASS 마크로 

NTFS(NTFiieSys^ 

nWinMode.25 

O 

OPAQUE 마크로 .229 

OPENFILENAME 구조체 .352 


OUT_DEFAULT_PRECIS 마크로 ..... 249 


P 

PAINTSTRUCT 구조체 .57, 217 

PASCAL.19 

PatbltO 함수 .708 

PatBltO 함수 .208, 210, 246 

PATCOPY 마크로 .208 

PBM_STEPIT 통보문 .365 

PBS_SMOOTH 형 식 마크로 . 365 

PBS_VERTICAL 형 식 마크로 . 365 

PeekMessage() 함수 . 682 

Pie() 함수 . 279 

POINT 구조체 . 31, 276 

Polygon。 함수 . 297 

POPUP 명 령문 . 82 

PostQuitMessage() 함수 . 32 

PrintDlg() 함수 . 680 

PrintDlgEx() 함수 . 645, 646 

PRINTDLGEX 구조체 . 647, 661 

PRINTDLG 구조체 . 680 

PRINTPAGERANGE 구조체 . 648 

PROCE 關 INFORMATION 구조체 . 593 

PROGRESS_CLASS. 365 

PropertySheet() 함수 . 445, 464 

PropSheet_Changed() 마크로 . 461 


PropSheet_SetWizButtons() 마크로 . 

PROPSHEETHEADER 극:▲처 :: ..... ^. 
. 445, 464, 466 


PROPSHEETPAGE 구조체 . 438, 464 

PS—INSIDEFRAME 마크로 . 280 

PSH_HASHELP 기 발 . 462 

PSH_WIZARD97 기 발 . 464, 466 

PSHNOTIFY 구조체 . 445 


PSM_CHANGED 통보문 . 448, 461 

PSM_SETCURSEL 통보문 . 461 

PSM_SETWIZBUTTONS 통보문 ..... 467 
PSN_HELP 통보문 . 462 


PSP_DLGINDIRECT 기 발 . 440 

PSP_USETITLE 기 발 . 440 

R 

R2_XORPEN. 283 

RC_BITBLT 마크로 . 663 


RC_STRETCHBLT 마크로 . 663 

RC 파일 . 80 

REALTIME_PRIORITY_ CLASS 콜라스 
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. 565 

Rectangle() 함수 . 278 

RECT 구조체 . 58 


REG_CREATE_NEW_KEY 마크로 ... 714 
REG_OPEN_EXISTING_KEY 마크로 

. 714 

REG_OPTION_BACKUP_RESTORE 마 

크로 . 714 

REG_OPTION_NON_VOLATILE 마크로 

. 714 

REG_OPTION_VOLATILE 마크로 ... 714 


RegCloseKey(). 716 

RegCreateKeyExO. 713, 714, 726 

REGEDIT. 717 

REGEDIT32. 709 

RegisterClassEx() 함수 .28 

RegisterDialogClassesO 함수.... 703, 708 

RegOpenKeyEx() 함수 .712 

RegQuery Value Ex() 함수 .715 

ReleaseDC() 함수 .51 

ReleaseSemaphore() 함수 .574 

ResetEvent() 함수 .580 

ResumeThread() 함수 .536, 550 

RGB() 마크로 .228 

RGB 값 .228 

RoundRect() 함수 .278 

RTEXT 조종체 .188 

RTF(Rich Text Format).599 

S 

SB_ THUMBTRACK 마크로 .“155 

SB_CTL 마크로 .152 

SB_HORZ 마크로 .152 

SB—LINEDOWN 마크로 .151, 155 

SB_LINELEFT 마크로 .152 

SB_LINERIGHT 마크로 .152, 156 

SB_LINEUP 마크로 .151, 155 

SB_PAGEDOWN 마크로 .151, 155 

SB_PAGERIGHT 마크로 .152 

SB_PAGEUP 마크로 .151, 155 

SB_THUMBPOSITION 마크로. 152, 155 

SB_THUMBTRACK 마크로 .152 

SB_VERT 마크로 .152 

SBARS_T00LTIPS 마크로 .385 

SBS_HORZ 형 식 마크로 .163 


ScreenSaverConfigureDialog() 함수.. 702 


ScreenSaverProcO 함수 .702, 703 

SCROLLBAR 명 령 문 .162 

SCROLLINFO 구조체 .153 

SECURITY-ATTRIBUTES 구조체 ... 714 
SECURITY-DESCRIPTOR 구조체 ... 788 

SelectObjectO 함수 .196, 208, 239 

SendDlgItemMessage() 함수 ..... 125, 173 

SendMessageO 함수 .326, 360, 365 

SetAbortProc() 함수 .682 

SetArcDirection() 함수 .277 

SetBkColor() 함수 .227 

SetBkModeO 함수 .228 

SetDlgItemInt() 함수 .380 

SetDlgItemText() 함수 .130 

SetDoubleClickTime() 함수 .74 

SetEvent() 함수 .581 

SetGraphicsMode() 함수 .300 

SetMapMode() 함수 .314 

SetMenu() 함수 .755 

SetMenuItemInfo() 함수 .735 

SetPixeK) 함수 .275 

SetRegValueEx() 함수 .714 

SetROP2() 함수 .282 

SetScrollInfo() 함수 .152 

SetTextColor() 함수 .227 

SetThreadPriority() 함수 .552 

SetTimerO 함수 .176 

SetViewportExtEx() 함수 .316 

SetViewportOrgEx() 함수 .317 

SetWaitableTimer() 함수 .583 

SetWindowExtEx() 함수 .315 

SetWindowLong() 함수 .447 

SetWindowPos() 함수 .494 

SetWorldTVansform() 함수 .298 

SHIFT 마크로 .92 

ShowMouseLoc() 함수 . 774, 775 

Show Window。 함수 .29 

SIF_POS.154 

SIZE 구조체 .232 

Sleep() 함수 .376 

SM_CXSCREEN 마크로 .209 

SM_CYSCREEN 마크로 .209 

sprintfO 함수 . 52, 237, 549 

SRCCOPY 마크로 .216 

StartDoc() 함수 .651 
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StartPage() 함수 . 652 

STARTUPINFO 구조체 . 592 

StretchBlt() 함수 . 662, 664 

STRINGTABLE 명 령 문 . 703 

strlen() 함수 . 231，715 

STYLE 명 령 문 . 116 

SuspendThread() 함수 . 550 

switch 명 령 문 . 20 

SystemTimeToFileTime() 함수 . 585 

SYSTEMTIME 구조체 . 525 

T 

TBBUTTON 구조체 . 327 

TBM_SETBUDDY 통보문 . 363, 382 

TBM_SETPOS 통보문 . 363 

TBM_SETRANGE 통보문 . 363 

TBS_AUTOTICKS 형 식 마크로 . 361 

TBSTYLE_TOOLTIPS. 330 

TCITEM 우조체 . 399 

TCM_ADJUSTRECT 통보문 . 402 

TCM_INSERTITEM 통보문 . 402 

TCN_SELCHANGE 통보문 . 402 

TCN_SELCHANGING 통보문 . 402 

TCS_BUTTONS 형 식 마크로 . 399 

TerminateProcess() 함수 . 594 

TerminateThread() 함수 . 536 

TEXTMETRIC 구조체 . 229 

TextOut() 함수 . 52, 237, 651 


THREAD_PRIORITY_ERROR_RETUR 

N 마크로 . 552 

THREAD_PRIORITY_NORMAL 마크로 


. 565 

TRACKBAR_CLASS 마크로 . 361 

TrackPopupMenuEx() 함수 

. 755, 757, 767 

TVanslateAccelerator() 함수 . 94 

TranslateMessage() 함수 . 32, 44, 95 

TRANSPARENT 마크로 . 229 

TrueType 서 체 . 239 

TTF_IDISHWND 마크로 . 332 

TVI_ROOT 마크로 . 423 

TVINSERTSTRUCT 구조체 . 422 

TVITEMEX 구조체 . 423 

TVITEM 구조체 . 423 

TVN_DELETEITEM 마크로 . 425 

TVN_ITEMEXPANDED 마크로 . 425 


TVN_ITEMEXPANDING 마크로 ...... 425 


TVN_SELCHANGED 마크로 . 425 

TVN_SELCHANGING 마크로 . 425 

TVS_HASBUTTONS 형 식 . 420 

TVS_HASLINES 형 식 . 420 

TVS_LINESATROOT 형 식 . 420 

typedef 명령문 . 20 

U，V 

UDM_SETPOS 통보문 . 360 

UINT 자료형 . 20 

UpdateWindow() 함수 . 30 

VIRTKEY 마크로 . 92 

W 

WaitForSingleObj ect() 함수 . 574 

WC_HEADER. 487 

WC_TABCONTROL. 398 

WC_TREEVIEW 콜라스 . 420 

wcl. 25 

Win 16 .11 

Win32.11 

WINAPI.19 

WindowFunc().32 

WINDOWPOS 구조체 .492 

Windows 2000.10 

Windows 2000 Professional.10 

WINDOWS.H 파일 .20 

WinHelp.596 

WinHelp() 함수 . 599, 609 

WinMain() 함수 .19, 25 

WINVER 마크로 .647 

Wizard97.464 

WM_CHAR 통보문 .40, 44 

WM_CHILD 통보문 .385 

WM_COMMAND 통보문 . 85, 98 

WM_CONTEXTMENU 통보문 . 

. 615, 617, 630 

WM_CREATE 통보문 . 194, 661, 707 

WM_DESTROY 통보문 ...... 197, 708, 786 

WM_ERASEBKGND 통보문 . 707 

WM_HELP 동보문 . 615 

WM_HSCROLL 통보문 . 162, 360 

WM_INITDIALOG 통보문 . 377, 726 

WM_KEYDOWN 통보문 . 44 

WM_KEYUP 통보문 . 44 
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WM_LBUTTONDBLCLIK 통보문 ...... 73 

WM_LBUTTONDBLCLK 통보문 . 68 

WM_LBUTTONDOWN 통보문 . 68 

WM_LBUTTONUP 통보문 . 73 

WM_MENURBUTTONUP 통보문 . 

. 728, 768 

WM_MOUSEMOVE 통보문 . 295 

WM_NOTIFY 통보문 . 326, 330, 402 

WM_PAINT 통보문 . 56, 58, 508, 680 

WM_RBUTTONDBLCLIK 통보문 ...... 73 

WM_RBUTTONDOWN 통보문 . 68 

WM_RBUTTONUP 통보문 . 73 

WM_SIZE 통보문 . 349, 397, 508 

WM_TIMER 통보문 . 150, 704 

WM—VSCROLL 통보문 . 162, 360 

WNDCLA 關 EX 구조체 ....... 21, 219, 221 

WORD 자료형 . 21 

wParam. 39 

WPARAM 자료형 . 39 

WS_BORDER 형 식 마크로 . 123, 326, 523 

WS—CHILD 형 식 . 359, 398, 420 

WS_EX_CONTEXTHELP 형 식 마크로 

WS_HSCROLL 형 국 4크로 . 151 

WS_OVERLAPPEDWINDOW 형 식 마크 

로 . 29 

WS_TABSTOP 형 식 마크로 116, 163, 420 

WS_VISIBLE 형 식 마크로 . 139, 523 

WS_VSCROLL 형 식 마크로 . 151 

wsprintf(). 549 


X，Z 


X2_XORPEN. 296 

XFORM 구조체 .299 

Z 차례 .492 


가변 간격 서 체 ...... 

가상건 . 

가상건코드 . 

가상창문 . 

작성과 사용법 . 

값의 _보관 . 

건반통보 . 

건입력 . 

검 사칸 . 


. 238 

. 93 

. 45 

207, 239, 666 

. 209 

. 715 

. 44, 49 

. 40, 41 

172, 176, 387 


고정 간격서 체.... 
고정령 역서 체.... 

골격 코드 . 

공통대화칸 ....... 

공통조종체 ....... 

균일 붓 . 

기 다림시 계 ....... 

기본차림표 ....... 

기억기장치상황 
기 억기 잃기 ....... 

계렬 . 


. 238 

. 238 

. 14 

. 322, 349 

111, 322, 486, 533 

. 281 

. 572, 582 


. 80 

,194, 195, 680 

. 51, 543 

. 238 


나무구조보기 

표식의 편집 . 434 

나무구조보기 조종체 . 419 

관련된 통지문 . 425 

실 례 프로그람 . 426 

주요통보문 . 421 

넘 기기 방식 . 314 

누름단추 . 111 

j ᅬ . 116 

내려 세기 시 계 

자원파일과 머 리 부파일 .....177 

프로그람코드 . 179 

내 부폐 지 . 464, 466 

내 장서 체 . 237, 239 

내장열쇠 . 710 

ᄃ 

다시그리^! 최적화 . 218 

다중과제 . 12, 534 

다중스레 드프로그람 . 535 

단추놓음통보문 . 73 

단추누름통보문 . 73 

단추형태 

머리 부항목 . 509 

단일 선택 단추 . 175, 176, 387 

도구설명 쪽지 . 330 

ᅬ . 326 

실례 프로그람 . 333 

도형 . 17, 274 

도형 방식 . 300 

. 596 

도움말파일 . 599 
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돌리 개 . 358 

돌리개조종체 . 

. 358, 361 ， 377, 379, 387, 717 

동기 화 . 534, 570 

동적련결 . 771 

동적 련결서 고 (DLL). 771 

간단한 서 고의 작성 . 774 

동적 차림 표 . 730 

동적 튀 여 나오기 차림 표 

작성 . 744 

확장판실 례 프로그람 .... 

머 리부항목을 삽입 . 

라 . 

목록 칸 . 

초기화 . 

44 . 

무ᅬ 붓 . 

문자렬 . 

문자모임 . 

문자획 - .. 

. 509 

. 495 

. 771 

. 111 

. 126, [127] 

. 123 

. 281 

. 50 

,...238, 246, 249 
, ..... 238 

두번찰칵 . 

. 73 

물리 단위 . 

. 314 

시 간간격 . 

. 73 

물리 창문 . 

. 209 

두번찰칵통보문 . 

. 73 

미 끄름조종체 . 

. 361 

대화단위 . 

. 466 



화소에로의 변환 . 

. 485 

H 


대화수속 . 

. 112 

반전 절 환 . 

. 173 

대화칸 . 

..... 17, 110, 387 

받침 선 . 

. 238 

밝 1 . 

. 113 

보안기능 . 

. 787 

실례프로그람 . 

. 118 

보안서술자 . 

. 714, 789 

자원 파일 . 

. 114 

보안식별자 (SID). 

. 788 

작개 . 

. 114 

보안회 계 관리 자 (SAM) 

. 789 

통보문의 처리 . 

. 112 

본문 


태 . 

. 113 

세 . 

. 229 

대화칸편집기 . 

. 114 

해 . 

. 232 

대화함수 . 

. 112 

호 Mi . 

. 257 



부모창문 . 
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